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']);
}