Payout details
This document lists the required details that needs to be sent for each of our payout corridor
Note Occasionally there might be issues with one of the corridors and we might have to disable them temporarily. Once youre onboarded we’ll let you know if this happens. Also if you’re trying to use a disabled corridor you’re going to receive a validation error stating that the corridor is not active, and you won’t be able to create new transactions there.
Nigeria
NGN::Bank
For Nigerian bank payments please use:
The valid bank_code
values are:
Note! Diamond Bank was merged with Access Bank in 2019. For Diamond Bank recipients please use Access Bank as the bank code
NGN::Mobile
For Nigerian mobile payments please use:
Warning! The recipient has to be registered and KYC’d with https://www.mypaga.com before they can receive funds. If they are not registered when the payment occurs then Paga can hold the funds until the user registers and approves themselves.
Ghana
GHS::Bank
For Ghanan bank payments please use:
The current banks supported and their bank_codes
values are:
Please note that there is no standard format across banks for account numbers in this corridor. If you wish to check for correctness you can see the following list:
GHS::Mobile
For Ghanan mobile payments please use:
Although the mobile_provider
field is optional, if you send us the proper value we can provider a quicker and faster settlement. The valid values are:
Uganda
UGX::Mobile
For Ugandan mobile payments please use:
Note! The provider might check the name against the registered holder of the mobile number and block transactions if they don’t match.
Tanzania
TZS::Mobile
For Tanzanian mobile payments please use:
Europe / SEPA
EUR::Bank
For EUR IBAN transfers please use:
Warning! If the recipient account is not an EUR
account then the recipient’s bank might charge for converting the received funds from EUR
to the local currency.
Note! Transfer is done using the fastest method available on the recipient’s bank.
- If the recipient’s bank supports the Instant Payment network funds will arrive within 2 hours (but usually within a couple minutes)
- If the recipient’s bank supports the SEPA system, funds will arrive within 1-2 business days
- If the recipient’s bank only supports the Swift system, funds will arrive within 2-5 business days
GBP::Bank
For GBP::Bank there are two payout options available:
- GBP Payments with account number and sort code
- GBP IBAN transfers
For GBP Payments with account number and sort code please use:
For GBP IBAN transfers please use:
Warning! If the recipient account is not an GBP
account then the recipient’s bank might charge for converting the received funds from GBP
to the local currency.
Note!
- The customer needs to enter either an IBAN (and an optional BIC), or an account number and sort code.
- Transfer is done using the fastest method available on the recipient’s bank.
- If the recipient’s bank is in the UK, and supports the Faster Payment network funds will arrive within 2 hours (but usually within a couple minutes)
- If the recipient’s bank supports the SEPA system, funds will arrive within 1-2 business days
- If the recipient’s bank only supports the Swift system, funds will arrive within 2-5 business days
Morocco
MAD::Cash
For Cashplus cash pickup requests please use:
Due to regulatory reasons all senders trying to create MAD::Cash
transactions need to have the following details present:
"identity_type" => "O"
- Values:"O"
: Other,"PP"
: Passport,"NI"
: National ID"identity_number" => "AB12345678"
"city_of_birth" => "London"
"country_of_birth" => "GB"
- ISO 2-letter format"gender" => "M"
- Values:"M"
: Male,"F"
: Female
Please note that the fields above are generally considered optional for senders for other payment corridors. If you wish to use an existing sender who has some of these fields missing you can provide them alongside the id
or external_id
field in the sender details. For example:
Please note when sending MAD::Cash
payments you should subscribe to the recipient.pending
webhook, as that will broadcast the payment reference ID the customer need to use to obtain the funds. Example webhook response excerpt:
The payment reference can also be provided in the recipient details hash optionally for MAD::Cash
in which case it will be used instead of the one we generate. The field you have to provide in the hash is called reference
. If you wish to use this functionality, please contact us for more details.
Note For a list of Cashplus pickup points please contact us
West Africa / XOF
XOF::Cash
For Senegalese cash pickup requests there are two payout provider options available:
- Wari (default)
- Wizall
For Wari cash pickup requests please use:
Please note when sending Wari cash pickup requests you should subscribe to the recipient.pending
webhook, as that will broadcast the payment reference ID the customer need to use to obtain the funds. Example webhook response excerpt:
The payment reference can also be provided in the recipient details hash optionally for Wari cash pickup requests in which case it will be used instead of the one we generate. The field you have to provide in the hash is called reference
. If you wish to use this functionality, please contact us for more details.
For Wizall cash pickup requests please use:
XOF::Mobile
For Senegalese mobile payments please use:
The valid mobile_provider
values are:
XOF::Bank
For West African bank payments in selected countries please use the following:
The valid bank_country
values are:
Note XOF::Bank
payouts are currently in beta phase. At this time, we offer payouts to accounts in Senegal and Benin only.
SouthAfrica
ZAR::Bank
For South African bank payments please use:
The current banks supported and their bank_codes
values are:
List of transfer reasons and corresponding transfer_reason_code
are:
Please note that due to regulatory reasons senders trying to create ZAR::Bank
transactions are required to have the following fields on the sender present:
street
, city
and postal_code
Note To accept payments in South Africa the recipient has to sign a mandate form online. The link to the form will be sent over the recipient’s mobile phone number and email address, and have to be filled out online. Once the mandate is signed it is valid for one year and the recipient doesn’t need to do these steps again. When sending funds to the same recipient please make sure their name and bank details are the same, otherwise they might be asked to sign the mandate form again.
Warning ZAR::Bank
payouts are currently in beta phase.