01When does it fire?
- When a refund is actually executed on a return.
- Once per refund execution — with the identity mwh:refund-executed:<tenant_id>:<refund_id>.
02Full payload example
{
"id": "mwh:refund-executed:9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b:e5f6a7b8-9c01-4234-8567-8a9b0c1d2e3f",
"type": "refund.executed",
"api_version": "v2",
"tenant_id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
"data": {
"refund_id": "e5f6a7b8-9c01-4234-8567-8a9b0c1d2e3f",
"return_id": "b4e1f7a2-9c30-4d58-8e6b-3f2a1d0c9b87",
"order_id": "3f0c8e6a-1d24-4b7f-9a3e-2c5b8d90f1aa",
"receipt_number": "RCP-20261020-1482",
"method": "VODAFONE_CASH",
"approved_amount": 225,
"amount": 225,
"executed_by": "1f2e3d4c-5b6a-4988-8a7b-6c5d4e3f2a1b",
"executed_at": "2026-10-21T10:02:15.330907+00:00",
"external_reference": "VF-20261021-778812",
"changed_at": "2026-10-21T10:02:15.331244+00:00",
"order": {
"order_id": "3f0c8e6a-1d24-4b7f-9a3e-2c5b8d90f1aa",
"receipt_number": "RCP-20261020-1482",
"order_type": "DELIVERY",
"order_source": "WEBSITE",
"status": "SHIPPED",
"customer_name": "Ahmed Mahmoud",
"customer_phone": "+201001234567",
"delivery_address": "15 El-Tahrir St., Dokki, Giza",
"table_number": null,
"branch_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"payment_method": "COD",
"coupon_code": "WELCOME10",
"total_amount": 624,
"tax_amount": 62,
"shipping_fee": 50,
"discount_amount": 50,
"created_at": "2026-10-20T12:34:56.789147+00:00",
"items": [
{
"product_id": "7a2b9c4e-8f31-4d5a-b6c2-1e9f8a7b6c5d",
"variant_id": "2c4e6f8a-0b1d-4e2f-8a3b-5c6d7e8f9a0b",
"name": "Cotton T-shirt - Blue / L",
"price": 225,
"quantity": 2
},
{
"product_id": "9d8c7b6a-5f4e-4d3c-2b1a-0f9e8d7c6b5a",
"variant_id": null,
"name": "Summer cap",
"price": 112,
"quantity": 1
}
],
"items_truncated": false
}
}
}03data fields
| Field | Meaning |
|---|---|
| refund_id | The refund id (UUID). |
| return_id | The linked return id. |
| order_id | The original order id. |
| receipt_number | The order receipt number. |
| method | The refund method — e.g. VODAFONE_CASH. |
| approved_amount | The amount approved for the return, in the store currency. |
| amount | The amount actually executed. |
| executed_by | The id of the executing user (UUID). |
| executed_at | When it was executed, ISO 8601. |
| external_reference | An external transfer reference (e.g. a wallet reference). |
| changed_at | When the refund row was last updated. |
| order | The full order summary — the same object as the order.created summary. |
04Event identity
Pattern: mwh:refund-executed:<tenant_id>:<refund_id> — constant across retries and replays.
COMPLETE YOUR INTEGRATION