Pay with Bank Transfer (Create Order)

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.

Method POST Request
Account Type Dynamic & Tracked
Settlement Rail PalmPay Direct (NGN)
Webhooks Instant (order.paid)
⚡ Two Flexible Ways to Collect Payments
  1. In-App Dynamic Bank Transfer: Display the returned virtual_account.account_number and bank_name directly inside your mobile app or website checkout.
  2. 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

POST

/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).
✓ Automated Webhooks & Returns

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

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/checkout/create-order', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'amount'         => 15000,
        'reference'      => 'ORD_INV_98234812',
        'customer_name'  => 'Musa Ibrahim',
        'customer_email' => 'musa@example.com',
        'customer_phone' => '08012345678',
        'title'          => 'Annual Subscription Plan',
    ]
]);

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

async function createCheckoutOrder() {
  try {
    const response = await axios.post('https://tente.com.ng/api/v1/checkout/create-order', {
      amount: 15000,
      reference: 'ORD_INV_98234812',
      customer_name: 'Musa Ibrahim',
      customer_email: 'musa@example.com',
      customer_phone: '08012345678',
      title: 'Annual Subscription Plan'
    }, {
      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);
  }
}

createCheckoutOrder();
import requests

url = "https://tente.com.ng/api/v1/checkout/create-order"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "amount": 15000,
    "reference": "ORD_INV_98234812",
    "customer_name": "Musa Ibrahim",
    "customer_email": "musa@example.com",
    "customer_phone": "08012345678",
    "title": "Annual Subscription Plan"
}

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

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

GET

/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"
  }
}
✓ Expected Webhook Response

Your webhook listener should respond with an HTTP 200 OK status code to acknowledge successful receipt.