GET /v1/countries

GET https://www.ashtechpay.com/v1/countries

Par défaut, cette requête retourne le catalogue des dépôts. Pour les retraits Mobile Money, ajoutez ?operation=payout :

GET https://www.ashtechpay.com/v1/countries?operation=payout

La réponse payout contient le code à envoyer comme country_code, les opérateurs de retrait actifs et wallet_currency, le wallet interne résolu pour ce pays. Le champ currency reste la devise ISO normalisée. wallet_currency est informatif : le payout choisit toujours le wallet côté serveur à partir du country_code.

Node.js
Python
cURL
PHP / Laravel

const response = await fetch("https://www.ashtechpay.com/v1/countries", {
  headers: {
    Authorization: `Bearer ${process.env.ASHTECH_API_KEY}`,
  },
});

const countries = await response.json();

import os
import requests

response = requests.get(
    "https://www.ashtechpay.com/v1/countries",
    headers={"Authorization": f"Bearer {os.environ['ASHTECH_API_KEY']}"},
)
countries = response.json()

curl https://www.ashtechpay.com/v1/countries \
  -H "Authorization: Bearer $ASHTECH_API_KEY"

<?php

$ch = curl_init("https://www.ashtechpay.com/v1/countries");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("ASHTECH_API_KEY"),
    ],
]);

$countries = json_decode(curl_exec($ch), true);
curl_close($ch);

La réponse contient les pays actifs, leur devise ISO normalisée et les opérateurs disponibles pour l’opération choisie. Utilisez le champ code pour sélectionner le pays. En mode operation=payout, wallet_currency indique le wallet interne que le serveur débitera. Le champ currency (XAF, XOF, etc.) ne représente pas toujours ce code interne. Pour une conversion, envoyez plutôt destination_country_code; AshTech Pay résout le wallet correspondant. Consultez Wallets et conversions pour le détail.

[
  {
    "code": "TG",
    "name": "Togo",
    "currency": "XOF",
    "operators": ["Flooz (Moov)", "Mixx By Yas"],
    "unavailable_operators": []
  }
]

Le catalogue peut évoluer. Rafraîchissez-le régulièrement et refusez côté serveur les opérateurs qui ne sont plus actifs.

Démarrer

Checkout

Integration

Direct API

Référence

Ressources