Payouts via online banking in Nigeria
Payouts via online banking in Nigeria are processed through direct credit requests.
| Parameter | Type | Required | Description |
|---|---|---|---|
pos_id | UUID | ✅ | Merchant's identifier (POS_ID) |
mode | MODE | ✅ | direct |
method | METHOD | ✅ | Payment method (credit) |
amount | Number | ✅ | Transaction amount. Must be a positive number. |
currency | CURRENCY | ✅ | Transaction currency (ISO_4217) |
order_3ds_bypass | String | ✅ | 3-D Secure flow option |
order_id | String | ✅ | Unique identifier of order |
description | String | ✅ | Payment description |
payway | String | ✅ | banking |
customer_fname | String | ✅ | Customer's first name |
customer_lname | String | ✅ | Customer's last name |
customer_email | String | ✅ | Customer's email |
customer_phone | String | ✅ | Customer's phone |
customer_id | String | Customer's identifier in merchant's system | |
properties.instrument_type | String | ✅ | Instrument type (bank_transfer) |
properties.instrument_method | String | ✅ | Instrument method (BANK_NGN) |
properties.account_number | String | ✅ | Recipient's account number |
server_url | URL | Webhook notification will be sent to this URL | |
result_url | URL | Customer 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"
}