Mandatory parameters

Mandatory parameterDescription
login32 chars
pass32 chars
external_idMax. 100 chars
beneficiary_nameMax. 50 chars
beneficiary_lastnameMax. 50 chars
countryNG
bank_codeSee bank codes below.
bank_accountSee bank account validations below.
amountMax. 2 decimal numbers
currency_to_payUSD
Mandatory only if the payout needs to be paid in USD.

In case this parameter is missing, the payout will be paid in local currency.
phoneMax. 15 chars
Mandatory only if the payout needs to be paid in USD.

Example request - NGN currency

{
"external_id":"1234567812345678",
"beneficiary_name":"Daniela",
"beneficiary_lastname":"Perez",
"country":"NG",
"amount":"4316.50",
"bank_code":"001",
"bank_account":"1234567891",
"currency":"NGN",
"comments":"this is the 1st comment",
"login":"1n234n56",
"pass":"HolAc123o",
}

Example request - USD currency

{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id":"1234567812345678",
"beneficiary_name":"Daniela",
"beneficiary_lastname":"Perez",
"country":"NG",
"amount":"4316.50",
"bank_code":"001",
"bank_account":"1234567891",
"currency":"USD",
"phone":"250700800900",
"comments":"this is the 1st comment",
"currency_to_pay":"USD"
}

Bank account validations

ValidationNameLengthTypeVerification digit
AccountNUBAN10numericApply verification algorithm

Bank codes

The payout will be paid in local currency unless the currency_to_pay param is specified.

Bank CodeBank NameSupport NGN currencySupport USD currency
044ACCESS BANK NIGERIA LTD
001CENTRAL BANK OF NIGERIA
559CORONATION MERCHANT BANK
063DIAMOND BANK LTD
050ECOBANK NIGERIA PLC
060002FBNQuest Merchant Bank Limited
070FIDELITY BANK PLC
608FINATRUST MICROFINANCE BANK
011FIRST BANK OF NIGERIA PLC
214FIRST CITY MONUMENT BANK
601FSDH MERCHANT BANK LIMIT
058GUARANTY TRUST BANK PLC
090121HASAL MICROFINANCE BANK
030HERITAGE BANK
090118IBILE MFB
301JAIZ BANK PLC
082KEYSTONE BANK LTD
561New Prudential Bank
023NIGERIA INTERNATIONAL BANK (CITIBANK)
552NPF Microfinance Bank
327PAGA
560Page MFBank
526PARALLEX MFB
101PROVIDUS BANK
502RAND MERCHANT BANK
076SKYE BANK PLC
221STANBIC IBTC BANK PLC
068STANDARD CHARTERED BANK NIGERIA LTD
232STERLING BANK PLC
100SUNTRUST BANK
032UNION BANK OF NIGERIA PLC
033UNITED BANK FOR AFRICA PLC
215UNITY BANK PLC
035WEMA BANK PLC
057ZENITH INTERNATIONAL BANK LTD