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:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "bank_code": "058",
  "bank_account": "123456789",
  "bank_account_type": "10"
    // 10 for saving
    // 20 for current accounts
}

The valid bank_code values are:

Access Bank: 044
Diamond Bank: 063
EcoBank: 050
FCMB Bank: 214
Fidelity Bank: 070
First Bank of Nigeria: 011
Guaranty Trust Bank : 058
Heritage Bank: 030
Jaiz Bank: 301
Keystone: 082
Polaris Bank: 076
Stanbic IBTC Bank: 039
Standard Chartered Bank PLC: 068
Sterling bank: 232
Suntrust Bank: 100
Union Bank: 032
United Bank for Africa: 033
Unity Bank: 215
Wema Bank: 035
Zenith International: 057

NGN::Mobile

For Nigerian mobile payments please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "7087661234"
    // local Nigerian format
}

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:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "bank_code": "030100",
  "bank_account": "123456789"
}

The current banks supported and their bank_codes values are:

Access Bank: 280100
Barclays Bank: 030100
GCB Bank: 040100
Ecobank: 130100
First National Bank: 330100
Heritage Bank: 370100
Prudential Bank: 180100
Stanbic Bank: 190100
Standard Chartered Bank: 020100
United Bank for Africa: 060100
Zenith Bank: 120100
Fidelity Bank: 240100

GHS::Mobile

For Ghanan mobile payments please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "302123456"
    // local Ghanaian format
}

Uganda

UGX::Mobile

For Ugandan mobile payments please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "256772123456"
    // local or international Ugandan format
}

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:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "221231234"
    // local Tanzanian format
}

Europe / SEPA

EUR::Bank

For EUR IBAN transfers please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "bank_name": "Deutsche Bank",
  "iban": "DE89370400440532013000",
  "bic": "DEUTDEBBXXX" // Optional
}

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:

  1. GBP Payments with account number and sort code
  2. GBP IBAN transfers

For GBP Payments with account number and sort code please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "bank_name": "Lloyds Bank",
  "bank_account": "12345678",
  "sort_code": "123456"
}

For GBP IBAN transfers please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "bank_name": "Lloyds Bank",
  "iban": "GB29LOYD60161331926819",
  "bic": "LOYDGB2L" // Optional
}

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:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "212537718685"
    // Mandatory; International format preferred
  "sender_identity_card_type" => "O",
    // Mandatory; Values: "O": Other, "PP": Passport, "NI": National ID
  "sender_identity_card_id" => 'AB12345678',
    // Mandatory
  "sender_city_of_birth" => "London",
    // Mandatory
  "sender_country_of_birth" => "GB",
    // Mandatory; ISO 2-letter format
  "sender_gender" => "M",
    // Mandatory; Values: "M": Male, "F": Female
  "reason" => "Remittance payment",
    // Optional; Default value is 'Remittance payment'
  "identity_card_type" => "NI",
    // Optional; Values: "PP": Passport, "NI": National ID
  "identity_card_id" => 'AB12345678'
    // Optional
}

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:

{
   (...)
   "state":"pending",
   "metadata": {
     "payment_reference":"9M5GJRJUBCY"
   },
   (...)
}

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 please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "phone_number": "774044436" // local Senegalese format
}

Please note when sending XOF::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:

{
   (...)
   "state":"pending",
   "metadata": {
     "payment_reference":"9M5GJRJUBCY"
   },
   (...)
}

The payment reference can also be provided in the recipient details hash optionally for XOF::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.

XOF::Mobile

For Senegalese mobile payments please use:

"details": {
  "first_name": "First",
  "last_name": "Last",
  "mobile_provider": "orange", // "orange" or "tigo"
  "phone_number": "774044436" // local Senegalese format
}

The valid mobile_provider values are:

orange
tigo

XOF::Bank

For West African bank payments in selected countries please use the following:

"details" : {
  "first_name": "First",
  "last_name": "Last",
  "bank_name": "BRM",
  "iban": "SN08SN0000000000000000000000",
  "bank_country": "SN" // "SN" or "BJ"
}

The valid bank_country values are:

SN
BJ

Note XOF::Bank payouts are currently in beta phase. At this time, we offer payouts to accounts in Senegal and Benin only.


Improve this page