🇳🇬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

API 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

external_id=100365001A2538925094
cashout_id=197824123
date=2025-03-18 10:10:10
bank_reference_id=999999250318115805775951234567
comments=
control=50553B0A13419744FF8CFFAD6711829863B5152E702FCDB123456789735671

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 (provider_external reference)

Bank Codes

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

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