Skip to main content

Payouts via online banking in Nigeria

Payouts via online banking in Nigeria are processed through direct credit requests.

ParameterTypeRequiredDescription
pos_idUUIDMerchant's identifier (POS_ID)
modeMODEdirect
methodMETHODPayment method (credit)
amountNumberTransaction amount. Must be a positive number.
currencyCURRENCYTransaction currency (ISO_4217)
order_3ds_bypassString3-D Secure flow option
order_idStringUnique identifier of order
descriptionStringPayment description
paywayStringbanking
customer_fnameStringCustomer's first name
customer_lnameStringCustomer's last name
customer_emailStringCustomer's email
customer_phoneStringCustomer's phone
customer_idStringCustomer's identifier in merchant's system
properties.instrument_typeStringInstrument type (bank_transfer)
properties.instrument_methodStringInstrument method (BANK_NGN)
properties.account_numberStringRecipient's account number
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment

Request example:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 1,
"method": "credit",
"currency": "NGN",
"payway": "banking",
"customer_email": "test@example.com",
"customer_fname": "Tom",
"customer_lname": "Hanks",
"customer_phone": "+900000000",
"properties": {
"instrument_type": "bank_transfer",
"instrument_method": "BANK_NGN",
"account_number": "1234567890"
},
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "1234567890",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}