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:
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.
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:
|
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"
}'
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. |