Payload Reference
Payment Status Webhook Payload
{
"merchantId": "41a77f74-8b67-4f04-be50-c8dd5ad8836f",
"customerId": "Abcam",
"consumerId": "60513141-4d0f-4d3d-9c8a-cc1bd61f40fd",
"merchantName": "John doe",
"paymentIdempotencyId": "ATOA1695808662681",
"status": "COMPLETED",
"statusDetails": null,
"paidAmount": "1005",
"tipAmount": "5.00",
"currency": "GBP",
"createdAt": "2023-09-27T09:57:50.067Z",
"updatedAt": "2023-09-27T09:57:50.067Z",
"taxAmount": 50.25,
"serviceAmount": 30.15,
"storeDetails": {
"id": "ee39ecfa-e336-461c-a957-1adc76ac087c",
"address": "Welwyn Garden City, Hertfordshire",
"locationName": "DEFAULT"
},
"orderId": "003decb3-c35",
"paymentRequestId": "6d1803f8-038a-48f3-8cd4-b44d37a3ab91",
"signatureHash": "1ea6ff07ca90ec4ca34dfd3b420dcdfe5db2d73e3a5de05e5379e8aa325a5e2e",
"errorDescription": "null",
"redirectUrlParams": "{}",
"redirectUrl": "https://paywithatoa.co.uk",
"splitBill": false,
"notes": "Transaction notes"
}
Delivered when a payment is completed, pending, or fails. Same payload structure for Pay by Bank and Card on File.
| Status | Description |
|---|---|
| COMPLETED | Payment processed successfully. Funds have been transferred to the merchant’s account. |
| PENDING | Payment is in progress and awaiting final confirmation from the bank. |
| FAILED | Transaction was unsuccessful. The customer will have to retry the payment. |
| AUTHORIZED | Card payment has been authorized but not yet captured. Only for MANUAL_CAPTURE or CAPTURE_BEFORE_EXPIRY card payments. |
| CANCELLED | An authorized card payment was cancelled before capture. |
Card on File: Card payments use the same payload with card-specific statuses (AUTHORIZED, CANCELLED). Use transactionType (CARD vs OPEN_BANKING) to distinguish payment types. See the Card on File guide for details.
V2 Webhook Signing: If you have enabled V2 webhook signing, the signatureHash and signature fields are removed from the payload and an eventType field is added. The webhook signature is delivered in the X-Atoa-Signature HTTP header instead.
{
"merchantId": "41a77f74-8b67-4f04-be50-c8dd5ad8836f",
"customerId": "Abcam",
"consumerId": "60513141-4d0f-4d3d-9c8a-cc1bd61f40fd",
"merchantName": "John doe",
"paymentIdempotencyId": "ATOA1695808662681",
"status": "COMPLETED",
"statusDetails": null,
"paidAmount": "1005",
"tipAmount": "5.00",
"currency": "GBP",
"createdAt": "2023-09-27T09:57:50.067Z",
"updatedAt": "2023-09-27T09:57:50.067Z",
"taxAmount": 50.25,
"serviceAmount": 30.15,
"storeDetails": {
"id": "ee39ecfa-e336-461c-a957-1adc76ac087c",
"address": "Welwyn Garden City, Hertfordshire",
"locationName": "DEFAULT"
},
"orderId": "003decb3-c35",
"paymentRequestId": "6d1803f8-038a-48f3-8cd4-b44d37a3ab91",
"signatureHash": "1ea6ff07ca90ec4ca34dfd3b420dcdfe5db2d73e3a5de05e5379e8aa325a5e2e",
"errorDescription": "null",
"redirectUrlParams": "{}",
"redirectUrl": "https://paywithatoa.co.uk",
"splitBill": false,
"notes": "Transaction notes"
}