Webhook Integration & Event Delivery
Tente Payment Gateway delivers instantaneous HTTP POST webhook notifications whenever customer deposits arrive on virtual accounts (Loma Bank Microfinance Bank, PalmPay, Monnify) or checkout payment links complete.
✨ Real-Time Inflow Callbacks with Loma Bank Microfinance Bank
Sub-Second Dispatch
Inflows sent to Loma Bank Microfinance Bank virtual accounts trigger sub-second webhook notifications with full NIP session identifiers, originator bank details, and automated transaction reconciliation.
Configuring Webhook Listeners
Configure your HTTPS webhook URL in the Developer Hub under API Keys & Webhooks. Ensure your listener script immediately responds with an HTTP 200 OK status code.
Standard Webhook Payload Structure
{
"event": "virtual_account.deposit",
"data": {
"transaction_ref": "LOMA_TX_98234812",
"reference": "CUST_98234812",
"account_number": "0052895910",
"account_name": "SHAFIU MUHAMMAD",
"bank_name": "Loma Bank microfinance Bank",
"bank_code": "090701",
"provider": "loma",
"amount": 5000.00,
"fee": 75.00,
"net_amount": 4925.00,
"payer_name": "Aliyu Garba",
"payer_account_no": "0123456789",
"session_id": "000914231311144221237185422093",
"status": "completed",
"created_at": "2026-11-11T13:45:00+01:00"
}
}
Cryptographic Signature Verification
Every webhook notification includes an X-Tente-Signature header. Compute the HMAC-SHA512 of the raw request payload using your Webhook Secret Key:
<?php
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_TENTE_SIGNATURE'] ?? '';
$secretKey = 'your_webhook_secret_key';
$expectedSignature = hash_hmac('sha512', $payload, $secretKey);
if (hash_equals($expectedSignature, $signature)) {
// Process verified deposit
http_response_code(200);
echo json_encode(['received' => true]);
} else {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
}