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 TypeDescription
c2b.payment_completedDispatched when a payment settles after OTP verification.
c2b.payment_failedCustomer cancelled OTP or entered invalid 6-digit code.
b2c.payout_completedDisbursement successfully credited to recipient 13-digit account.
b2c.payout_failedDisbursement rejected by recipient account rules.
escrow.vault_lockedTrade funds locked into atomic escrow vault.
escrow.funds_releasedEscrow release confirmed; funds transferred to seller.
agent.order_completedPhysical 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"
  }
}