Skip to main content
Use this page to map webhook status / code pairs to their meaning and expected payload fields.

​
Status codes

statuscodeMeaning
CREATED100Request created, awaiting processing.
PENDING101In progress and awaiting confirmation.
SUCCESS102Completed successfully.
FAILED103Attempt failed.
ESCALATED104Needs further review/manual intervention.
EXPIRED105Request expired before completion.
REFUNDED106Payment successfully refunded.
REVERSED107Payment reversed; funds returned due to error or cancellation.

​
Example payload (SUCCESS)

{
  "status": "SUCCESS",
  "code": "102",
  "description": "Payment completed successfully",
  "results": {
    "result_code": "0",
    "result_description": "The service request is processed successfully.",
    "amount": 100,
    "total_charges": 10,
    "total_amount": 100,
    "account": "254708374149",
    "transaction_reference": "295877",
    "payment_uuid": "413283551145761444",
    "external_reference": "3C1HH10ZU8",
    "time_processed": "2026-01-07T09:48:08.8485958",
    "validation_hash": "16b70a72ab3abddd1a2ed3db533317be9785fa553beafb563d205cec5a693b6c",
    "metadata": {}
  }
}
For the full field list, see Webhook payload. Verify the integrity hash as shown in Verify signature.