Payouts via online banking in Nigeria
To make account credits using online banking in Nigeria, a request to the Tranzzo API must contain the following parameters:
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. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50) |
currency | CURRENCY | ✅ | NGN |
order_3ds_bypass | String | ✅ | 3-D Secure flow option |
order_id | String | ✅ | Unique identifier of order |
description | String | ✅ | Payment description |
payway | String | ✅ | banking |
server_url | URL | Webhook notification will be sent to this URL | |
result_url | URL | Customer will be redirected to this URL after payment. | |
customer_fname | String | Payer’s first name | |
customer_lname | String | Payer’s last name | |
recipient_phone | String | Payer’s phone number. The parameter is mandatory for iban instrument type | |
customer_email | String | Payer’s email address | |
properties.instrument_type | String | ✅ | Instrument type |
properties.account_number | String | ✅ | Recipient’s bank account number (provided by client) |
properties.bank_account | String | ✅ | Recipient’s bank ID (provided by client) |
properties.address | String | ✅ | Recipient’s address (provided by client) |
Request example:
{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 400,
"method": "credit",
"currency": "NGN",
"payway": "banking",
"Properties":{
"instrument_type": "bank_transfer",
"account_number": "9026633",
"bank_account": "0001",
"address": "address"
},
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "123456789",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}