Payout & Disbursements API
Bank Payouts & Transfers API
Programmatically disburse instant bank payouts to all commercial banks, microfinance banks, and digital mobile banks across Nigeria with automatic name verification and real-time status tracking.
Base Endpoints
4 Endpoints
Authentication
Bearer Token
Settlement Speed
Instant (0-15s)
Coverage
100+ NG Banks
1. Get Supported Banks List
GET
/api/v1/banks
Fetch the complete list of supported Nigerian financial institutions with their official bank codes and logos.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
search |
string | Optional | Filter banks by name or code (e.g. ?search=access or ?search=044). |
Sample Success Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Banks retrieved successfully.",
"data": [
{
"id": 1,
"bank_name": "Access Bank",
"bank_code": "044",
"logo": "https://tente.ng/assets/banks/access.png",
"is_active": true
},
{
"id": 2,
"bank_name": "Guaranty Trust Bank (GTBank)",
"bank_code": "058",
"logo": "https://tente.ng/assets/banks/gtb.png",
"is_active": true
},
{
"id": 3,
"bank_name": "PalmPay",
"bank_code": "999991",
"logo": "https://tente.ng/assets/banks/palmpay.png",
"is_active": true
},
{
"id": 4,
"bank_name": "Moniepoint MFB",
"bank_code": "50515",
"logo": "https://tente.ng/assets/banks/moniepoint.png",
"is_active": true
},
{
"id": 5,
"bank_name": "Zenith Bank",
"bank_code": "057",
"logo": "https://tente.ng/assets/banks/zenith.png",
"is_active": true
}
]
}
2. Verify Account Name (Account Enquiry)
POST
/api/v1/transfer/verify-account
Perform a real-time name lookup for any Nigerian bank account number before initiating a disbursement payout.
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bank_code |
string | Required | Destination bank code (e.g. 058 or 999991). |
account_number |
string | Required | 10-digit NUBAN account number (e.g. 0123456789). |
Sample Request Body
{
"bank_code": "058",
"account_number": "0123456789"
}
Sample Success Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Account verified successfully.",
"data": {
"account_number": "0123456789",
"account_name": "JOHN CHUKWUDI DOE",
"bank_code": "058",
"bank_name": "Guaranty Trust Bank (GTBank)"
}
}
3. Initiate Payout Transfer
POST
/api/v1/transfer
Disburse funds instantly from your merchant wallet to any beneficiary bank account in Nigeria.
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | Required | Bearer API Token (e.g. Bearer your_api_token_here) |
Content-Type |
string | Required | application/json |
Accept |
string | Required | application/json |
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
amount |
numeric | Required | Disbursement amount in Naira (minimum ₦100.00). |
bank_code |
string | Required | Valid destination Nigerian bank code (e.g. 058). |
account_number |
string | Required | 10-digit NUBAN destination account number. |
account_name |
string | Optional | Beneficiary account name (will be automatically resolved if omitted). |
reference |
string | Required | Unique merchant payout tracking reference (e.g. PAYOUT_98401824). |
narration |
string | Optional | Payment description / remark to appear on beneficiary bank statement. |
Code Snippets
curl -X POST "https://tente.com.ng/api/v1/transfer" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"amount": 25000,
"bank_code": "058",
"account_number": "0123456789",
"account_name": "JOHN CHUKWUDI DOE",
"reference": "PAYOUT_98401824",
"narration": "Vendor Settlement"
}'
Success Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Transfer payout executed successfully.",
"data": {
"reference": "PAYOUT_98401824",
"transaction_ref": "TRF8A72B3C910D2",
"amount": 25000,
"fee": 0,
"tax": 50,
"total_debited": 25000,
"status": "completed",
"beneficiary": {
"bank_name": "Guaranty Trust Bank (GTBank)",
"bank_code": "058",
"account_number": "0123456789",
"account_name": "JOHN CHUKWUDI DOE"
},
"narration": "Vendor Settlement",
"created_at": "2026-09-05T15:00:00+01:00",
"updated_at": "2026-09-05T15:00:02+01:00"
}
}
4. Query Transfer Status
GET
/api/v1/transfer/{reference}
Retrieve details and completion status for any payout transfer using your merchant reference or the system transaction reference.
Sample Success Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Transfer details retrieved successfully.",
"data": {
"reference": "PAYOUT_98401824",
"transaction_ref": "TRF8A72B3C910D2",
"amount": 25000,
"fee": 0,
"tax": 50,
"total_debited": 25000,
"status": "completed",
"beneficiary": {
"bank_name": "Guaranty Trust Bank (GTBank)",
"bank_code": "058",
"account_number": "0123456789",
"account_name": "JOHN CHUKWUDI DOE"
},
"narration": "Vendor Settlement",
"created_at": "2026-09-05T15:00:00+01:00",
"updated_at": "2026-09-05T15:00:02+01:00"
}
}