Passer au contenu principal
GET /mobile-money/countries renvoie les pays ouverts pour votre compte, leurs opérateurs, et pour chaque opérateur et devise : l’état en direct, les montants minimum et maximum, les décimales et votre prix tout compris. C’est tout ce qu’il faut pour construire un écran de paiement.

Codes

  • Les pays utilisent les codes ISO 3166-1 alpha-3 (CMR, CIV, COD), les devises l’ISO 4217 (XAF, XOF, KES).
  • Chaque opérateur a un code stable : la marque et le pays, par exemple MTN_CMR ou ORANGE_CIV. Enregistrez ce code, pas le nom.

Lisez l’état avant d’afficher un opérateur

Utilisez available. Masquez un opérateur de votre écran de paiement quand collection.available vaut false, et proposez les autres opérateurs du pays. Un opérateur fermé revient souvent en quelques minutes ou quelques heures. Les payouts et remboursements ne sont pas encore ouverts : leur état est donné pour information, et les remboursements n’ont pas encore de prix (fee: null).

Montants et décimales

  • min_amount et max_amount s’appliquent à ce que paie le client, par transaction.
  • decimals est le nombre de décimales accepté par cet opérateur. 0 veut dire montants entiers seulement (5000, pas 5000.50).
Les décimales dépendent de l’opérateur, pas seulement de la devise. En Ouganda, MTN_UGA accepte 2 décimales et AIRTEL_UGA aucune, tous deux en UGX. Arrondissez aux decimals de l’opérateur choisi par votre client.

Pays activés pour votre compte

Tous les pays sont activés par défaut. Un pays désactivé pour votre compte disparaît de la liste, et le demander renvoie 422 COUNTRY_NOT_SUPPORTED. Contactez le support si vous en avez besoin.

Bonnes pratiques

Les données des opérateurs sont rafraîchies toutes les 10 minutes chez nous. Mettez-les en cache sur votre serveur au lieu d’appeler l’API à chaque affichage de page.
Les opérateurs les changent, parfois sans prévenir. Lisez-les dans l’API.
Appelez POST /mobile-money/predict-operator, ou laissez operator vide quand vous demandez un paiement : nous le devinons à partir du numéro.
Voir la liste complète dans Pays couverts.