Amounts and currencies
How Monerail represents money.
Amounts are integers in the minor unit of the currency. Never send decimals: 10.5 is rejected with 400 parameter_invalid.
| Currency | Minor unit | amount: 5000 means |
|---|---|---|
| XAF, XOF, GNF, RWF, UGX | the franc or shilling itself (no decimals) | 5,000 |
| CDF | centime: send whole francs only (multiples of 100) | FC 50 |
| NGN | kobo | ₦50.00 |
| KES | cent | KSh 50.00 |
| GHS | pesewa | GH₵50.00 |
| TZS | cent | TSh 50.00 |
| USD (cards) | cent | $50.00 |
Currencies for collections and payouts
| Currency | Collections | Payouts and settlements |
|---|---|---|
XAF (Central Africa: Cameroon, Gabon, Chad, Congo, Central African Republic) |
Yes | Yes |
XOF (West Africa: Senegal, Côte d’Ivoire, Benin, Togo, Burkina Faso, Mali, Niger) |
Yes | Yes |
GNF (Guinea), CDF (DR Congo) |
Yes | Yes (mobile money) |
KES, GHS, UGX, TZS, RWF |
Yes | Yes |
NGN |
No: 400 currency_unsupported |
Yes |
Which operators are open in each currency comes from List operators.
When you leave out country, Monerail uses the main country of the currency: CM for XAF, SN for XOF, GN for GNF, CD for CDF, NG for NGN, KE for KES, GH for GHS, UG for UGX, TZ for TZS, RW for RWF. To collect or pay out in Gabon, Chad, Congo or the Central African Republic (XAF), or in Côte d’Ivoire, Benin, Togo, Burkina Faso, Mali or Niger (XOF), send country.
Cards
Cards, card funding and the cards balance are in US dollars, in cents. Your cards balance is separate from your balances in African currencies.
Fees
Fees are in the same currency and unit as the operation:
- Collections: the fee is deducted from what you receive.
net = amount − fee, known once the collection succeeds. - Payouts: the fee is debited from your balance on top of
amount. The recipient receivesamountin full. - Cards: issuing and payment fees are debited from the card.
Current prices are on monerail.com/pricing.