Pay with Bank Transfer & Payment Links API
Modeled after PalmPay's high-speed Pay with Bank Transfer gateway. Generate dynamic temporary virtual bank accounts and hosted payment links with real-time automated settlement and downstream merchant webhooks.
POST Request
Dynamic & Tracked
PalmPay Direct (NGN)
Instant (order.paid)
- In-App Dynamic Bank Transfer: Display the returned
virtual_account.account_numberandbank_namedirectly inside your mobile app or website checkout. - Hosted Payment Link: Simply redirect your customer to the returned
payment_url(e.g.https://tente.ng/pay/ORD_...) for a complete checkout experience with live countdown timer and auto-refresh.
1. Create Bank Transfer Order & Payment Link
/api/v1/checkout/create-order
Generate a dynamic payment order with an assigned temporary virtual account and hosted payment link URL.
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 | Order amount in Naira (minimum ₦50.00). |
reference |
string | Required | Your merchant unique order tracking ID (e.g. ORD_INV_98234812). |
customer_name |
string | Required | Full name of the customer paying for the order. |
customer_email |
string | Optional | Customer's email address for receipt notifications. |
customer_phone |
string | Optional | Customer's mobile phone number (e.g. 08012345678). |
title |
string | Optional | Order title to display on the checkout page (e.g. Invoice #4920). |
description |
string | Optional | Short description / item summary. |
expiry_minutes |
integer | Optional | Dynamic account validity in minutes (defaults to 60 minutes). |
You do not need to send callback_url or return_url in your POST request. TENTE automatically sends the webhook notification to your Webhook URL and redirects to the Success Return URL saved in your Dashboard API settings.
Sample Request Body
{
"amount": 15000,
"reference": "ORD_INV_98234812",
"customer_name": "Musa Ibrahim",
"customer_email": "musa@example.com",
"customer_phone": "08012345678",
"title": "Annual Subscription Plan",
"description": "Payment for Pro SaaS Tier",
"expiry_minutes": 60
}
Code Snippets
curl -X POST "https://tente.com.ng/api/v1/checkout/create-order" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"amount": 15000,
"reference": "ORD_INV_98234812",
"customer_name": "Musa Ibrahim",
"customer_email": "musa@example.com",
"customer_phone": "08012345678",
"title": "Annual Subscription Plan"
}'
Success Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Payment order created successfully.",
"data": {
"reference": "ORD_INV_98234812",
"tente_reference": "ORD_A7B8C9D0E1F2",
"amount": 15000,
"fee": 150,
"net_settled": 14850,
"currency": "NGN",
"title": "Annual Subscription Plan",
"description": "Pay with Bank Transfer",
"payment_url": "https://tente.com.ng/pay/ORD_A7B8C9D0E1F2",
"checkout_url": "https://checkout.palmpay.com/h5-checkout/?countryCode=NG&tntCode=PALMPAY&payToken=...",
"virtual_account": {
"bank_name": "PalmPay",
"bank_code": "100033",
"account_number": "9928401824",
"account_name": "TENTE - Arewa Smart Idea Ltd",
"expires_at": "2026-09-10T19:30:00+01:00",
"expiry_seconds": 3600
},
"customer": {
"name": "Musa Ibrahim",
"email": "musa@example.com",
"phone": "08012345678"
},
"payer": {
"account_name": null,
"bank_name": null
},
"status": "pending",
"paid_at": null,
"created_at": "2026-09-10T18:30:00+01:00"
}
}
2. Query Order Status
/api/v1/checkout/order/{reference}
Check real-time payment status using your merchant order reference or TENTE internal reference.
Sample Completed Response (200 OK)
{
"status": 200,
"meaning": "Successful",
"message": "Order details retrieved successfully.",
"data": {
"reference": "ORD_INV_98234812",
"tente_reference": "ORD_A7B8C9D0E1F2",
"amount": 15000,
"fee": 150,
"net_settled": 14850,
"currency": "NGN",
"status": "completed",
"payer": {
"account_name": "MUSA IBRAHIM",
"bank_name": "PalmPay"
},
"paid_at": "2026-09-05T16:05:22+01:00",
"created_at": "2026-09-05T16:00:00+01:00"
}
}
3. Webhook Notification Specifications
When the customer transfers funds into the dynamic virtual account, TENTE immediately receives the settlement, credits your account, and sends an HTTP POST webhook to your callback_url (or registered account webhook URL).
Event: order.paid
{
"event": "order.paid",
"timestamp": "2026-09-05T16:05:22+01:00",
"data": {
"reference": "ORD_INV_98234812",
"tente_reference": "ORD_A7B8C9D0E1F2",
"amount": 15000,
"fee": 150,
"settled_amount": 14850,
"currency": "NGN",
"status": "completed",
"title": "Annual Subscription Plan",
"customer": {
"name": "Musa Ibrahim",
"email": "musa@example.com",
"phone": "08012345678"
},
"payer": {
"account_name": "MUSA IBRAHIM",
"bank_name": "PalmPay"
},
"destination": "hold_balance",
"transaction_ref": "DEP_98401824PLM",
"paid_at": "2026-09-05T16:05:22+01:00"
}
}
Your webhook listener should respond with an HTTP 200 OK status code to acknowledge successful receipt.