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

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

Bank Codes

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

Bank	Bank Code
Polaris Bank	8
Taj Bank	26
Globus Bank	103
Titan-Paystack	100039
Paga	327
One Finance	100026
GoMoney	100022
Keystone Bank Ltd	82
Kuda Bank	50211
Zenith Bank International	100034

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