Couverture
Les pays, devises et opérateurs mobile money, et ceux que l’API accepte aujourd’hui.
Monerails couvre 22 pays d’Afrique dans 11 devises : XAF, XOF, GNF, CDF, GMD, NGN, GHS, KES, UGX, TZS et RWF. 16 pays sont ouverts aujourd’hui. Le Ghana, le Nigéria, le Kenya, l’Ouganda, la Tanzanie et le Rwanda sont en cours d’activation. La disponibilité est aussi en cours d’extension 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 |
| RD Congo | CD |
CDF |
Oui (USD : en ouverture) |
Airtel Money, M-Pesa, Orange Money, Afrimoney, Vodacom |
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, Djamo |
| Sénégal | SN |
XOF |
Oui | Orange Money, Wave, Mixx by Yas (ex-Free Money), E-money |
| Bénin | BJ |
XOF |
Oui | MTN MoMo, Moov Money, Celtiis Cash, Coris Money |
| Togo | TG |
XOF |
Oui | Mixx by Yas (ex-TMoney), Moov Money |
| Burkina Faso | BF |
XOF |
Oui | Orange Money, Moov Money, Wave |
| Ghana | GH |
GHS |
En cours d’activation | MTN MoMo, Telecel Cash, AirtelTigo Money |
| Nigéria | NG |
NGN |
En cours d’activation (paiements d’abord) | 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, Moov Money, Amanata, Nita, Zamani Cash |
| Guinée-Bissau | GW |
XOF |
Oui | Orange Money |
| Gambie | GM |
GMD |
Oui | Afrimoney |
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 : envoyez country (CI, BJ, TG, BF, ML, NE, GW) pour les autres pays du XOF. Les montants en GMD sont en dalasis entiers (multiples de 100 bututs).
Afrique de l’Est
| Pays | ISO | Devise | Disponible dans l’API | Principaux opérateurs |
|---|---|---|---|---|
| Kenya | KE |
KES |
En cours d’activation | M-Pesa, Airtel Money |
| Ouganda | UG |
UGX |
En cours d’activation | MTN MoMo, Airtel Money |
| Tanzanie | TZ |
TZS |
En cours d’activation | Vodacom M-Pesa, Airtel Money, Mixx by Yas (Tigo), Halotel |
| Rwanda | RW |
RWF |
En cours d’activation | MTN MoMo, Airtel Money |
Virements bancaires
Le Ghana, le Nigéria, le Kenya, l’Ouganda, la Tanzanie et le Rwanda sont en cours d’activation : jusqu’à leur ouverture, les encaissements renvoient 400 currency_unsupported, et les paiements, les virements bancaires et Lister les banques renvoient 400 country_unsupported. Les virements bancaires y seront disponibles dès l’ouverture. Au Cameroun, en Côte d’Ivoire, au Sénégal, au Bénin, au Togo, au Burkina Faso, au Gabon, au Tchad, au Congo, en Centrafrique, en RD Congo, en Guinée, en Guinée-Bissau, en Gambie, 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, GW |
MOOV |
Moov Money | GA, TD, CI, BJ, TG, BF, ML, NE |
AIRTEL |
Airtel Money | GA, TD, CG, CD, NE, NG, KE, UG, TZ, RW |
WAVE |
Wave | CI, SN, BF |
FREE |
Mixx by Yas (ex-Free Money) | SN |
EMONEY |
E-money | SN |
TMONEY |
Mixx by Yas (ex-TMoney) | TG |
CELTIIS |
Celtiis Cash | BJ |
CORIS |
Coris Money | BJ |
DJAMO |
Djamo | CI |
MPESA |
M-Pesa | CD, KE |
AFRIMONEY |
Afrimoney | CD, GM |
VODACOM |
Vodacom (RD Congo), Vodacom M-Pesa (Tanzanie) | CD, TZ |
AMANATA |
Amanata | NE |
NITA |
Nita | NE |
ZAMANI |
Zamani Cash | NE |
TIGO |
Mixx by Yas (ex-Tigo Pesa) | TZ |
TELECEL |
Telecel Cash (ex-Vodafone Cash) | GH |
AIRTEL_TIGO |
AirtelTigo Money | GH |
Pour Halotel (Tanzanie), utilisez le code renvoyé par Lister les opérateurs pour 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.
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.monerails.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
Le Ghana, le Nigéria, le Kenya, l’Ouganda, la Tanzanie et le Rwanda sont en cours d’activation, en mode test comme en production. La disponibilité dans l’API est aussi en cours d’extension aux encaissements en NGN et à l’USD en RD Congo. D’ici là, l’USD est refusé 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@monerails.com.