Payload Reference
Refund Status Webhook Payload
{
"refundId": "c4e92a73-5f12-47c9-8b31-6e54f2d8a91c",
"paymentRequestId": "8f2471db-3456-9cd8-eff2-1a3b5c7d9e0f",
"paymentIdempotencyId": "ATOA1893245678912",
"status": "COMPLETED",
"paidAmount": 785.25,
"refundAmount": 50.75,
"currency": "GBP",
"refundNotes": "Customer requested partial refund",
"orderId": "892365417",
"createdAt": "2025-04-12T09:23:45.612Z",
"updatedAt": "2025-04-12T09:25:18.743Z",
"signatureHash": "9a2b8c4d6e3f1a5b7c9d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b"
}
Delivered when a refund is completed, fails, or is cancelled. Excludes POS terminal voids, which are delivered under POS_PAYMENT_STATUS.
| Status | Description |
|---|---|
| COMPLETED | Refund has been completed and credited to the customer’s bank account. |
| FAILED | Refund could not be processed at this time. |
| CANCELLED | Refund has been cancelled by one of your users. |
For V1 signing, signatureHash is computed from orderId and refundId — see the V1 Signing guide. With V2 signing enabled, signatureHash is removed and replaced by the X-Atoa-Signature header.
{
"refundId": "c4e92a73-5f12-47c9-8b31-6e54f2d8a91c",
"paymentRequestId": "8f2471db-3456-9cd8-eff2-1a3b5c7d9e0f",
"paymentIdempotencyId": "ATOA1893245678912",
"status": "COMPLETED",
"paidAmount": 785.25,
"refundAmount": 50.75,
"currency": "GBP",
"refundNotes": "Customer requested partial refund",
"orderId": "892365417",
"createdAt": "2025-04-12T09:23:45.612Z",
"updatedAt": "2025-04-12T09:25:18.743Z",
"signatureHash": "9a2b8c4d6e3f1a5b7c9d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b"
}