Montants et devises
Comment Monerails représente l’argent.
Les montants sont des entiers dans l’unité mineure de la devise. N’envoyez jamais de décimales : 10.5 est refusé avec 400 parameter_invalid.
| Devise | Unité mineure | amount: 5000 signifie |
|---|---|---|
| XAF, XOF, GNF, RWF, UGX | le franc ou le shilling lui-même (sans décimales) | 5 000 |
| CDF | centime : envoyez des francs entiers seulement (multiples de 100) | 50 FC |
| GMD | butut : envoyez des dalasis entiers seulement (multiples de 100) | 50 D |
| NGN | kobo : envoyez des nairas entiers seulement (multiples de 100) | 50 ₦ |
| KES | cent : envoyez des shillings entiers seulement (multiples de 100) | 50 KSh |
| GHS | pesewa : envoyez des cedis entiers seulement (multiples de 100) | 50 GH₵ |
| TZS | cent : envoyez des shillings entiers seulement (multiples de 100) | 50 TSh |
| USD (cartes) | cent | 50,00 $ |
Les encaissements, paiements, reversements mobile money et liens de paiement en CDF, GMD, NGN, KES, GHS et TZS doivent être en unités entières : le montant doit être un multiple de 100 (amount: 250000 = 2 500 KSh est accepté, amount: 250050 = 2 500,50 KSh est refusé avec 400 amount_invalid). Les frais restent calculés et indiqués en unités mineures : un solde peut donc comporter des centimes.
Devises des encaissements et paiements
| Devise | Encaissements | Paiements et reversements |
|---|---|---|
XAF (Afrique centrale : Cameroun, Gabon, Tchad, Congo, Centrafrique) |
Oui | Oui |
XOF (Afrique de l’Ouest : Sénégal, Côte d’Ivoire, Bénin, Togo, Burkina Faso, Mali, Niger, Guinée-Bissau) |
Oui | Oui |
GNF (Guinée), CDF (RD Congo), GMD (Gambie) |
Oui | Oui (mobile money) |
KES, GHS, UGX, TZS, RWF |
En cours d’activation : 400 currency_unsupported |
En cours d’activation : 400 country_unsupported |
NGN |
Pas encore : 400 currency_unsupported |
En cours d’activation : 400 country_unsupported |
Les opérateurs ouverts dans chaque devise sont donnés par Lister les opérateurs.
Sans country, Monerails prend le pays principal de la devise : CM pour XAF, SN pour XOF, GN pour GNF, CD pour CDF, GM pour GMD, NG pour NGN, KE pour KES, GH pour GHS, UG pour UGX, TZ pour TZS, RW pour RWF. Pour encaisser ou payer au Gabon, au Tchad, au Congo ou en Centrafrique (XAF), ou en Côte d’Ivoire, au Bénin, au Togo, au Burkina Faso, au Mali, au Niger ou en Guinée-Bissau (XOF), envoyez country.
Cartes
Les cartes, leurs recharges et le solde cartes sont en dollars, en cents. Votre solde cartes est distinct de vos soldes en devises africaines.
Frais
Les frais sont dans la même devise et la même unité que l’opération :
- Encaissements : les frais sont déduits de ce que vous recevez.
net = amount − fee, connu une fois l’encaissement réussi. - Paiements : les frais sont débités de votre solde en plus de
amount. Le bénéficiaire reçoitamounten entier. - Cartes : les frais sont toujours débités de la carte concernée, jamais de votre solde cartes. Chaque frais est une transaction distincte de type
card_fee, dont le champfeeindique le type (processing,issuer_cross_border,maintenance…) et, le cas échéant, le paiement auquel il se rattache. Si le solde de la carte ne suffit pas, le frais reste dû et il est prélevé à la recharge suivante. Voir Frais des cartes.
Les tarifs en vigueur sont sur monerails.com/fr/pricing.