Couverture
Les pays, devises et opérateurs mobile money, et ceux que l’API accepte aujourd’hui.
Monerail couvre 22 pays d’Afrique. L’API en accepte 20 aujourd’hui, dans 10 devises : XAF, XOF, GNF, CDF, NGN, GHS, KES, UGX, TZS et RWF. La disponibilité est en cours d’extension aux 2 pays marqués En ouverture, aux encaissements en NGN et à l’USD en RD Congo. Les cartes sont émises en dollars et s’utilisent en ligne partout dans le monde, là où Visa ou Mastercard est accepté.
Les tableaux ci-dessous sont un repère. La référence pour votre intégration est Lister les opérateurs : la liste des opérateurs ouverts à l’instant pour une devise (et, avec country, pour un pays), dans le mode de votre clé. Les opérateurs et plafonds de votre entreprise sont confirmés lors de l’ouverture du compte.
Afrique centrale
| Pays | ISO | Devise | Disponible dans l’API | Principaux opérateurs |
|---|---|---|---|---|
| Cameroun | CM |
XAF |
Oui | MTN MoMo, Orange Money |
| Gabon | GA |
XAF |
Oui | Airtel Money, Moov Money |
| Tchad | TD |
XAF |
Oui | Airtel Money, Moov Money |
| Congo | CG |
XAF |
Oui | MTN MoMo, Airtel Money |
| Centrafrique | CF |
XAF |
Oui | Orange Money, Telecel Money |
| RD Congo | CD |
CDF |
Oui (USD : en ouverture) |
Airtel Money, M-Pesa, Orange Money, Afrimoney |
Le XAF est partagé par six pays : envoyez country (GA, TD, CG, CF) pour encaisser ou payer hors du Cameroun. Sans lui, XAF désigne le Cameroun.
Afrique de l’Ouest
| Pays | ISO | Devise | Disponible dans l’API | Principaux opérateurs |
|---|---|---|---|---|
| Côte d’Ivoire | CI |
XOF |
Oui | Orange Money, MTN MoMo, Moov Money, Wave |
| Sénégal | SN |
XOF |
Oui | Orange Money, Wave, Free Money |
| Bénin | BJ |
XOF |
Oui | MTN MoMo, Moov Money |
| Togo | TG |
XOF |
Oui | TMoney, Moov Money |
| Burkina Faso | BF |
XOF |
Oui | Orange Money, Moov Money |
| Ghana | GH |
GHS |
Oui | MTN MoMo, Telecel Cash, AirtelTigo Money |
| Nigéria | NG |
NGN |
Paiements : oui. Encaissements : en ouverture | MTN MoMo, Airtel, virement bancaire |
| Guinée | GN |
GNF |
Oui | MTN MoMo, Orange Money |
| Mali | ML |
XOF |
Oui | Orange Money, Moov Money |
| Niger | NE |
XOF |
Oui | Airtel Money |
Au Nigéria, les paiements partent vers les portefeuilles mobile money et les comptes bancaires. Les encaissements en NGN renvoient 400 currency_unsupported jusqu’à leur ouverture. Sans country, XOF désigne le Sénégal.
Afrique de l’Est
| Pays | ISO | Devise | Disponible dans l’API | Principaux opérateurs |
|---|---|---|---|---|
| Kenya | KE |
KES |
Oui | M-Pesa, Airtel Money |
| Ouganda | UG |
UGX |
Oui | MTN MoMo, Airtel Money |
| Tanzanie | TZ |
TZS |
Oui | Vodacom M-Pesa, Airtel Money, Mixx by Yas (Tigo), Halotel |
| Rwanda | RW |
RWF |
Oui | MTN MoMo, Airtel Money |
Afrique australe
| Pays | ISO | Devise | Disponible dans l’API | Principaux opérateurs |
|---|---|---|---|---|
| Zambie | ZM |
ZMW |
En ouverture | MTN MoMo, Airtel Money, Zamtel |
| Afrique du Sud | ZA |
ZAR |
En ouverture | Virement bancaire et EFT |
Virements bancaires
Les paiements vers un compte bancaire sont disponibles au Cameroun, en Côte d’Ivoire, au Sénégal, au Bénin, au Togo, au Burkina Faso, au Ghana, au Nigéria, au Kenya, en Ouganda, en Tanzanie et au Rwanda (Lister les banques donne les banques de chaque pays). Au Gabon, au Tchad, au Congo, en Centrafrique, en RD Congo, en Guinée, au Mali et au Niger, payez vers des portefeuilles mobile money : un virement bancaire renvoie 400 bank_transfer_unsupported.
Codes opérateurs
Indiquez l’opérateur dans operator pour un encaissement, ou dans recipient.operator pour un paiement mobile money, avec le country correspondant. Ces codes sont reconnus :
| Code | Opérateur | Disponible en |
|---|---|---|
MTN |
MTN MoMo | CM, CG, CI, BJ, GN, GH, NG, UG, RW |
ORANGE |
Orange Money | CM, CF, CD, CI, SN, BF, ML, GN |
MOOV |
Moov Money | GA, TD, CI, BJ, TG, BF, ML |
AIRTEL |
Airtel Money | GA, TD, CG, CD, NE, NG, KE, UG, TZ, RW |
WAVE |
Wave | CI, SN |
FREE |
Free Money | SN |
MPESA |
M-Pesa | CD, KE |
AFRIMONEY |
Afrimoney | CD |
VODACOM |
Vodacom M-Pesa | TZ |
TIGO |
Mixx by Yas (ex-Tigo Pesa) | TZ |
TELECEL |
Telecel Cash (ex-Vodafone Cash), Telecel Money | GH, CF |
AIRTEL_TIGO |
AirtelTigo Money | GH |
Pour TMoney (Togo) et Halotel (Tanzanie), utilisez le code renvoyé par Lister les opérateurs pour XOF ou TZS. Dans tous les cas, préférez le code de Lister les opérateurs à une valeur écrite en dur : c’est exactement ce que l’API attend.
Opérateurs qui envoient un code
La plupart des opérateurs demandent au client de valider le paiement sur son téléphone avec son code PIN. Certains lui envoient plutôt un code à usage unique par SMS : l’encaissement passe alors en requires_otp et vous transmettez le code avec authorize. C’est le cas, par exemple, d’Orange Money au Cameroun.
Chez d’autres opérateurs, c’est le client qui génère le code : Orange Money en Guinée, par exemple. L’encaissement est requires_otp dès le départ et next_action.ussd_code contient le code USSD à composer (*144*4*2*1#). Affichez-le à votre client, demandez-lui le code obtenu et transmettez-le avec authorize. Rien n’est envoyé à l’opérateur avant le code ; sans code dans les 15 minutes, l’encaissement expire.
Le mode de validation d’un opérateur peut changer : ne l’écrivez pas en dur. Lisez authorization sur chaque opérateur de Lister les opérateurs : PIN signifie une validation sur le téléphone, OTP un code à envoyer avec authorize. Le guide des encaissements présente les deux parcours.
La liste en direct
curl "https://api.monerail.com/v1/operators?currency=XAF&country=TD" \
-H "Authorization: Bearer $MONERAIL_KEY"Appelez-la pour chaque devise (et pour chaque pays en XAF et XOF), gardez la réponse quelques minutes en cache (l’API la met en cache jusqu’à 10 minutes) et remplissez votre sélecteur d’opérateurs avec. Les nouveaux opérateurs apparaissent alors sans changer votre code.
Pays en ouverture
La disponibilité dans l’API est en cours d’extension à la Zambie et à l’Afrique du Sud, aux encaissements en NGN et à l’USD en RD Congo. D’ici là, ZMW, ZAR et USD sont refusés pour les encaissements et les paiements avec 400 currency_unsupported. Chaque ouverture est annoncée dans le journal des modifications. Pour demander un pays absent de la liste, écrivez à support@monerail.com.