Virtual Account POST

/api/v1/virtual-accounts/create

The Static Virtual Account API allows businesses to programmatically generate permanent, dedicated Nigerian virtual bank accounts for their end-customers across Loma Bank Microfinance Bank, PalmPay, and Monnify.

✨ NEW & RECOMMENDED: Loma Bank Microfinance Bank
Highest Success Rate (99.9%)
We strongly recommend all businesses and developers adopt Loma Bank Microfinance Bank (Bank Code: 090701) as your primary collection channel:
  • Superior NIP Inflow Deliverability: Near-zero latency with over 99.9% uptime on incoming bank transfers from all Nigerian banking apps.
  • Instant Dynamic Settlement: Automatic funds sweep directly into your master settlement wallet via DYNAMIC_FUND.
  • Zero Integration Hassle: Simply pass "bank": "loma" (or "provider": "loma") in your create request payload!
⚡ Static & Non-Expiring Account Guarantee
Account Type: static | Expiry: None (Permanent)
These accounts remain active indefinitely unless manually disabled by your administrative panel. Customers can transfer funds of any amount into their assigned account at any time.

1. Create Static Virtual Account

Send a POST request with the customer's details and your chosen bank (loma, palmpay, moniepoint, or auto).

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
bank string Optional Target partner bank:
  • loma (Recommended): Loma Bank Microfinance Bank (Bank Code: 090701).
  • palmpay: PalmPay partner rails (Bank Code: 100033).
  • moniepoint: Moniepoint Microfinance Bank (Bank Code: 50515).
  • auto: Smart priority routing with automatic active bank failover.
provider string Optional Alias for bank: accepts loma (Recommended), palmpay, moniepoint, or auto.
funding_method string Optional Settlement mode for Loma Bank: DYNAMIC_FUND (default, automatically sweeps collected funds to master wallet) or STATIC_FUND.
reference string Required Your merchant unique customer / account tracking reference (e.g., CUST_98234812).
customer_name string Required Full name of the end customer (e.g., john doe).
customer_email string Optional Valid email address of the customer for receipts and notifications.
customer_phone string Optional Customer's Nigerian mobile phone number (e.g. 08012345678).
bvn string Optional 11-digit Bank Verification Number for Tier KYC compliance.
date_of_birth string Optional Date of birth in YYYY-MM-DD format matching BVN record (e.g. 2000-01-01).
address string Optional Customer's residential or business address (e.g. 12 Admiralty Way, Lekki Phase 1, Lagos).
🏦 Supported Bank Options & Partner Rails
Your customers can transfer funds into their generated virtual accounts using any Nigerian commercial bank or fintech mobile app:
  • Loma Bank Microfinance Bank (Recommended | NIP Bank Code: 090701 | Value: loma)
  • PalmPay (Bank Code: 100033 | Value: palmpay)
  • Moniepoint Microfinance Bank (Bank Code: 50515 | Value: moniepoint)

Sample Request Body (Recommended: Loma Bank Microfinance Bank)

{
  "bank": "loma",
  "reference": "CUST_98234812",
  "customer_name": "john doe",
  "customer_email": "example@gmail.com",
  "customer_phone": "08012345678",
  "bvn": "22123456789",
  "date_of_birth": "2000-01-01",
  "address": "12 Admiralty Way, Lekki Phase 1, Lagos",
  "funding_method": "DYNAMIC_FUND"
}

Code Snippets

curl -X POST "https://tente.com.ng/api/v1/virtual-accounts/create" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "bank": "loma",
    "reference": "CUST_98234812",
    "customer_name": "john doe",
    "customer_email": "example@gmail.com",
    "customer_phone": "08012345678",
    "bvn": "22123456789",
    "date_of_birth": "2000-01-01",
    "address": "12 Admiralty Way, Lekki Phase 1, Lagos",
    "funding_method": "DYNAMIC_FUND"
  }'
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/virtual-accounts/create', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'bank'           => 'loma',
        'reference'      => 'CUST_98234812',
        'customer_name'  => 'john doe',
        'customer_email' => 'example@gmail.com',
        'customer_phone' => '08012345678',
        'bvn'            => '22123456789',
        'date_of_birth'  => '2000-01-01',
        'address'        => '12 Admiralty Way, Lekki Phase 1, Lagos',
        'funding_method' => 'DYNAMIC_FUND',
    ]
]);

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

async function createVirtualAccount() {
  try {
    const response = await axios.post('https://tente.com.ng/api/v1/virtual-accounts/create', {
      bank: 'loma',
      reference: 'CUST_98234812',
      customer_name: 'john doe',
      customer_email: 'example@gmail.com',
      customer_phone: '08012345678',
      bvn: '22123456789',
      date_of_birth: '2000-01-01',
      address: '12 Admiralty Way, Lekki Phase 1, Lagos',
      funding_method: 'DYNAMIC_FUND'
    }, {
      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);
  }
}

createVirtualAccount();
import requests

url = "https://tente.com.ng/api/v1/virtual-accounts/create"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "bank": "loma",
    "reference": "CUST_98234812",
    "customer_name": "john doe",
    "customer_email": "example@gmail.com",
    "customer_phone": "08012345678",
    "bvn": "22123456789",
    "date_of_birth": "2000-01-01",
    "address": "12 Admiralty Way, Lekki Phase 1, Lagos",
    "funding_method": "DYNAMIC_FUND"
}

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

Success Response (200 OK - Loma Bank Microfinance Bank)

{
  "status": 200,
  "meaning": "Successful",
  "message": "Static virtual account created successfully.",
  "data": {
    "reference": "CUST_98234812",
    "account_reference": "2d796027-cfdc-437a-9e5e-146d6710e8e1",
    "account_number": "0052895910",
    "account_name": "john doe",
    "bank_name": "Loma Bank microfinance Bank",
    "bank_code": "090701",
    "provider": "loma",
    "account_type": "static",
    "status": "active",
    "accounts": [
      {
        "bank_name": "Loma Bank microfinance Bank",
        "bank_code": "090701",
        "account_number": "0052895910",
        "account_name": "john doe",
        "account_reference": "2d796027-cfdc-437a-9e5e-146d6710e8e1"
      }
    ],
    "created_at": "2026-11-11T13:45:00+01:00"
  }
}

2. Query Virtual Account Details & Status

GET

/api/v1/virtual-accounts/{reference}

Retrieve details and active status for an existing static virtual account using your merchant reference, the account reference, or the account number.

Path Parameters

Parameter Type Required Description
reference string Required Your merchant reference, provider account reference, or 10-digit account number.

Success Response (200 OK)

{
  "status": 200,
  "meaning": "Successful",
  "message": "Virtual account details retrieved successfully.",
  "data": {
    "reference": "CUST_98234812",
    "account_reference": "PP8A72B3C910D2",
    "account_number": "9928374610",
    "account_name": "TENTE - Musa Ibrahim",
    "bank_name": "PalmPay",
    "bank_code": "999991",
    "provider": "palmpay",
    "account_type": "static",
    "status": "active",
    "customer": {
      "name": "Musa Ibrahim",
      "email": "musa@example.com",
      "phone": "08012345678"
    },
    "created_at": "2026-09-01T15:00:00+01:00"
  }
}

Response Codes

Status Code Meaning HTTP Status Description
200 SUCCESS 200 OK Operation completed successfully.
201 TRANSACTION_FAILED 200 OK Provider failed to allocate account number.
203 INVALID_TOKEN 401 Unauthorized Missing or invalid Bearer API Token.
206 INVALID_REQUEST 200 OK Missing or invalid required request parameters.
215 NO_RECORD_FOUND 200 OK Virtual account reference not found on your merchant account.