eSMS AfricaeSMS Africa
Billing

Multi-currency

How currency conversion works across African countries.

How currencies work

eSMS Africa supports multiple currencies. Your wallet holds a balance in one currency, while each route charges in its own local currency. The platform converts automatically at the time of send.

Balance before
1,500.00 USD
Route ESMS_UG - 100 segments
35 UGX ÷ 3,726 (FX) = $0.0094 / seg
Total: −$0.94 USD
Balance after
1,499.06 USD
Route: ESMS_UG (Uganda)FX Rate: 1 USD = 3,726 UGX

Supported wallet currencies

CurrencyCountryCode
US DollarInternationalUSD
Kenyan ShillingKenyaKES
Ugandan ShillingUgandaUGX
Nigerian NairaNigeriaNGN
Ghanaian CediGhanaGHS
South African RandSouth AfricaZAR
Tanzanian ShillingTanzaniaTZS
Rwandan FrancRwandaRWF
Zambian KwachaZambiaZMW
Zimbabwe GoldZimbabweZIG

Your wallet currency is set when you create your account. Contact support to change it.

FX rates

Exchange rates are refreshed every 6 hours from a live market data feed. The rate used for your transaction is shown in the transaction details.

USD is used as the pivot currency for all conversions: UGX → USD → KES. This ensures consistent, transparent pricing.

Conversion example

Scenario: wallet in KES, sending to Uganda (ESMS_UG route, 35 UGX/segment)

Route price
35 UGX
÷ 3,726 (FX)
0.009394 USD
× 129.13 (FX)
1.213 KES
USD is the pivot currency - UGX → USD → KES
Wallet: KESRoute: ESMS_UG (Uganda)

Your transaction log will show -1.21 KES for a 1-segment message to Uganda.

Route currencies

Each route charges in its local currency:

RouteCountryBilling currencyPrice/segment
ESMS_UGUgandaUGX35.00
ESMS_KEKenyaKES1.20
ESMS_NGNigeriaNGN9.10
ESMS_GHGhanaGHS0.08
ESMS_ZASouth AfricaZAR0.15

Check Coverage & Pricing for the full up-to-date list.

Pre-check cost

Use the bulk pre-check endpoint to see exact costs before sending:

POST /api/messages/bulk-precheck

The response shows:

  • route_cost - cost in the route's local currency
  • wallet_cost - cost in your wallet currency (after FX conversion)
  • wallet_currency - your wallet currency

This lets you verify the exact amount that will be deducted from your wallet before you commit.

On this page