Products

Mobile money

Send money from your naira balance to mobile money wallets in Ghana, Kenya and Tanzania.

Mobile money, per country, is switched on by request. Ask from Settings › Products and access; once approved it works in test and live mode. Until then the API answers 403 with the code shown below.

  1. GET/v1/mobile_money/operators?country=GH: the networks (GH, KE or TZ).
  2. POST/v1/mobile_money/quote with country and amount in the destination's minor units (5000 is GH₵50): the naira it costs now, with the fee.
  3. POST/v1/mobile_money with country, operator, mobile_number (with country code), amount, and optionally account_name, reference and max_total.

Set max_total to the most naira you agreed to (from the quote): if the rate moved above it, nothing is sent and you get 409 rate_changed. It then works like a transfer: transfer.success or transfer.failed. Not switched on: 403 mobile_money_not_enabled.