Skip to main content

Online banking in Nigeria

To enable online banking in Nigeria, you need to use direct integration. When creating a payment, send a request with the following parameters:

ParameterTypeRequiredDescription
pos_idUUID✅Merchant's identifier (POS_ID)
modeMODE✅direct
methodMETHOD✅Payment method (purchase)
amountNumber✅Transaction amount. Must be a positive number. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50)
currencyCURRENCY✅NGN
order_3ds_bypassString✅3-D Secure flow option
order_idString✅Unique identifier of order
descriptionString✅Payment description
paywayString✅banking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
customer_fnameString✅Payer’s first name
customer_lnameString✅Payer’s last name
customer_emailString✅Payer’s e-mail address
customer_phoneString✅Payer’s phone number

Request example:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 1000,
"method": "purchase",
"currency": "NGN",
"payway": "banking",
"customer_fname": "John",
"customer_lname": "Doe",
"customer_phone": "380999999999",
"customer_email": "[email protected]",
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "123456789",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}
info

To process payouts via online banking in Nigeria, please refer to the instructions.