🇳🇬Nigeria

Check the requirements and validations made over the cashouts on Nigeria

Required fields

Field	Format	Description
login	String	Cashouts login
pass	String	Cashouts pass
external_id	String (max length: 100)	Transaction's ID on your end
document_id	See document validations	Beneficiary's document ID
country	NG	See country codes
currency	NGN / USD	See currency codes
amount	Number with up to 2 decimals	Cashout amount
bank_account	See validations below	Beneficiary's bank account
bank_code	See bank codes	Code specifying the beneficiary's bank
beneficiary_name	String (max length: 100)	Beneficiary's name
beneficiary_lastname	String (max length: 100)	Beneficiary's last name

Bank Account Validations

Bank name	Bank code	Format	Example
All	-	Numeric	123456789, 9283749293

Document Validations

Click here to check document types and validations.

Example Request

Request

{
    "login": "xxxxxxx",
    "pass": "xxxxxxx",
    "external_id": "30000000001",
    "country": "NG",
    "amount": 100,
    "currency": "NGN",
    "bank_account": "123456789",
    "bank_code": "11", 
    "document_id": "892374233",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

Response

We now return session ID for cashouts in Nigeria as the bank_reference_id field in the API response as well as the API callback

Bank Codes

Bank	Bank Code
Diamond Bank	005
Fidelity Bank	007
Polaris Bank	008
First Bank of Nigeria Plc	011
First Bank of Nigeria	016
Taj Bank	026
Lotus Bank	029
Union Bank Nigeria Plc	032
United Bank for Africa Plc	033
WEMA Bank Plc	035
Access Bank Plc	044
Ecobank Nigeria	050
Zenith Bank International	057
Guaranty Trust Bank Plc	058
Standard Chaterted Bank PLC	068
Fidelity Bank Plc	070
Keystone Bank Ltd	082
ProvidusBank PLC	101
Globus Bank	103
First City Monument Bank	214
Unity Bank Plc	215
Stanbic IBTC Bank	221
Sterling Bank Plc	232
Jaiz Bank	301
Opay	305
Zenith Mobile	322
Paga	327
Kuda Bank	50211
VFD MFB	90110
RenMoney Microfinance Bank	90198
Kuda Microfinance Bank	90267
Rolez Microfinance Bank	90405
Fairmoney Microfinance Bank Ltd	90551
Paycom(Opay)	100004
Stanbic IBTC @ease wallet	100007
GoMoney	100022
PalmPay Limited	100033
9Payment Service Bank	120001
MoMo PSB	120003
SmartCash PSB	120004

For the full and most up-to-date list of banks and its codes, please check the Cashout Bank Code endpoint.