Event Directory
Webhooks are dispatched within 160ms of ledger settlement. Automatic exponential retries occur over a 72-hour window if your endpoint is unreachable.
| Event Type | Description |
|---|---|
c2b.payment_completed | Dispatched when a payment settles after OTP verification. |
c2b.payment_failed | Customer cancelled OTP or entered invalid 6-digit code. |
b2c.payout_completed | Disbursement successfully credited to recipient 13-digit account. |
b2c.payout_failed | Disbursement rejected by recipient account rules. |
escrow.vault_locked | Trade funds locked into atomic escrow vault. |
escrow.funds_released | Escrow release confirmed; funds transferred to seller. |
agent.order_completed | Physical counter cash-in/out completed with counter verification. |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Sample Event Payload
{
"type": "c2b.payment_completed",
"id": "evt_vxz_948201",
"created_at": "2026-09-07T02:30:14.441Z",
"data": {
"transaction_id": "TXN_C2B_84920199",
"type": "paybill",
"amount": 2500,
"currency": "KES",
"status": "COMPLETED",
"payer": {
"account_number": "3810482910482",
"name": "Ismail Farah Abdullahi"
},
"ledger_receipt": "REC_LEDGER_84920188"
}
}