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"
  }'
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/transfer', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'amount'         => 25000,
        'bank_code'      => '058',
        'account_number' => '0123456789',
        'account_name'   => 'JOHN CHUKWUDI DOE',
        'reference'      => 'PAYOUT_98401824',
        'narration'      => 'Vendor Settlement',
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
const axios = require('axios');

async function initiatePayout() {
  try {
    const response = await axios.post('https://tente.com.ng/api/v1/transfer', {
      amount: 25000,
      bank_code: '058',
      account_number: '0123456789',
      account_name: 'JOHN CHUKWUDI DOE',
      reference: 'PAYOUT_98401824',
      narration: 'Vendor Settlement'
    }, {
      headers: {
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Content-Type': 'application/json'
      }
    });

    console.log(response.data);
  } catch (error) {
    console.error(error.response ? error.response.data : error.message);
  }
}

initiatePayout();
import requests

url = "https://tente.com.ng/api/v1/transfer"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "amount": 25000,
    "bank_code": "058",
    "account_number": "0123456789",
    "account_name": "JOHN CHUKWUDI DOE",
    "reference": "PAYOUT_98401824",
    "narration": "Vendor Settlement"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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"
  }
}