Mobile Money Transfer
This endpoint supports wallet withdrawals to mobile money accounts for supported currencies.
Supported Currencies
Transfer Flow
Step 1: Ensure Sufficient Balance
Ensure the user has sufficient wallet balance for the selected currency before initiating a transfer.
Step 2: Fetch Supported Mobile Money Providers
Retrieve the list of supported mobile money providers for the selected country and currency by calling the utility endpoint:
Example:
Use the returned provider code as the value for the network field when initiating the transfer.
The idempotencykey header is required. Generate a new key for every new exchange. Only reuse a key when retrying the same request after a timeout or network error.
Fields
Required
Conditionally Required
Optional
Sample Request Payloads
GHS Mobile Money Transfer
XOF Mobile Money Transfer
Notes
- Fees may apply and will be deducted from the wallet balance.
- For
XOF and XAF, the iso2 field is mandatory and must match the selected country.
- Always fetch providers from
/transaction/{method}/providers before initiating transfers.
- Transfers are subject to mobile network processing times.
- Invalid phone numbers, unsupported providers, or incorrect country codes will result in validation errors.
