Overview:
Bank Transfer (NUBAN) allows direct payouts to Nigerian bank accounts using the NUBAN (Nigerian Uniform Bank Account Number) format. This method supports instant settlements via local banking networks for all major banks (GTBank, Access, Zenith, First Bank, etc.).
Required Fields:
| Field | Type | Requirement Level | Description |
|---|---|---|---|
amount | number | Required | Amount in the local currency |
currency | string | Required | NGN |
method_code | string | Required | "BANK_TRANSFER_NGN" |
recipient.wallet_uid | string | Required | Recipient’s bank account number |
recipient.full_name | string | Required | Recipient’s bank account name |
bank.code | string | Required | Bank code |
reference | string | Required | Merchant reference |
metadata | object | Optional | Merchant metadata |
webhook_url | string | Optional | HTTPS URL for notifications |
sender.full_name | string | Optional | Sender's full name |
sender.address | string | Optional | Sender's address |
sender.phone | string | Optional | Sender's phone number |
Sample Payload:
{
"amount": 100,
"currency": "NGN",
"method_code": "BANK_TRANSFER_NGN",
"recipient": {
"wallet_uid": "01712345678",
"full_name": "Firstname Surname",
},
"bank": {
"code": "90001",
},
"reference": "INV-2025-001",
"metadata": {
"internal_id": "user1234"
},
"webhook_url": "https://yourwebsite.com/webhook",
"sender": {
"full_name": "Firstname Surname",
"address": "No 2, Green Median Str"
}
}
