> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waftpay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Types

> Quick reference for webhook statuses and example payloads.

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

## Status codes

| status    | code | Meaning                                                        |
| --------- | ---- | -------------------------------------------------------------- |
| CREATED   | 100  | Request created, awaiting processing.                          |
| PENDING   | 101  | In progress and awaiting confirmation.                         |
| SUCCESS   | 102  | Completed successfully.                                        |
| FAILED    | 103  | Attempt failed.                                                |
| ESCALATED | 104  | Needs further review/manual intervention.                      |
| EXPIRED   | 105  | Request expired before completion.                             |
| REFUNDED  | 106  | Payment successfully refunded.                                 |
| REVERSED  | 107  | Payment reversed; funds returned due to error or cancellation. |

## Example payload (SUCCESS)

```json theme={null}
{
  "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](/pages/webhooks/payload). Verify the integrity hash as shown in [Verify signature](/pages/webhooks/verify-signature).