Part of these flowsThis webhook is the last step of the Refund flow.
Triggered when an approved card transaction is refunded.
This webhook is sent only after the original transaction has been approved. It indicates that the cardholder or merchant has initiated a refund or purchase cancellation for a previously approved transaction. This is a notification: no immediate credit action is required on your side.
A refund is processed as a separate transaction event and does not mean that the original approved transaction is deleted or reverted. A refund can also arrive without referencing an earlier authorization at all — see "Refunds without a matched authorization" in Non-Standard Transaction Scenarios.
Amount fields
The payload carries two amount/currency pairs. Both describe the amount being returned to the cardholder — it is independent of the original authorization or settlement amount: a refund can be for less than (or, in principle, more than) what was originally charged, and it never modifies the original transaction record.
accountAmount/accountCurrency— the refunded amount credited to the card account, in the account currency.transactionAmount/transactionCurrency— the refunded amount in the original transaction currency.
Deprecated:amountandtransactionCurrencyCodeThe
amountandtransactionCurrencyCodefields are deprecated and will be removed after 2026-10-01 — migrate to the fields above.
amounthas always contained the account-side amount (equal toaccountAmount).transactionCurrencyCodewas previously never populated due to a bug. During the deprecation window it is populated and contains the account currency (same asaccountCurrency), not the original transaction currency.
{
"userId": "a59906a1-9bed-4491-804f-6ab82ce056ce",
"event": "CardTransactionRefunded",
"transaction": {
"transactionId": "a0680001-005c-d9c5-997b-08de9a25f2ba",
"cardId": "6e0cb7e6-c8f2-4ccf-a750-04983a0e1a5d",
"status": "Refunded",
"statusText": "Pending",
"merchant": "aliexpress.com",
"accountAmount": 473.57,
"accountCurrency": "GBP",
"transactionAmount": 529.99,
"transactionCurrency": "USD",
"amount": 473.57,
"transactionCurrencyCode": "GBP",
"createdAt": "2026-04-14T13:01:31.12Z",
"declineReason": null,
"authorizationId": "a0680001-005c-d9c5-997b-08de9a25f2ba"
}
}