CardTransactionReversed

Triggered when transaction reversal happens


📘

Part of these flows

This webhook is the last step of the Reversal flow.

Amount fields

The payload carries two amount/currency pairs. Both describe the amount being released from the hold placed by the original authorization — it is not the amount that stays authorized, and it is not a debit or a refund:

  • accountAmount / accountCurrency — the released amount in the card account currency.
  • transactionAmount / transactionCurrency — the released amount in the original transaction currency.

A reversal is always linked to a specific prior authorization (via authorizationId) and can be partial: only part of the authorized amount may be released, for example when a fuel-pump pre-authorization exceeds the amount actually dispensed. See "Partial reversals" in Non-Standard Transaction Scenarios for worked examples.

A reversal is not a refund: it cancels an authorization that has not settled, while a refund (see CardTransactionRefunded) returns funds after settlement.

⚠️

Deprecated: amount and transactionCurrencyCode

The amount and transactionCurrencyCode fields are deprecated and will be removed after 2026-10-01 — migrate to the fields above.

  • amount has always contained the account-side amount (equal to accountAmount).
  • transactionCurrencyCode was previously never populated due to a bug. During the deprecation window it is populated and contains the account currency (same as accountCurrency), not the original transaction currency.
{
  "userId": "f35aff3d-928d-4969-be9a-636b899d97f6",
  "event": "CardTransactionReversed",
  "transaction": {
    "transactionId": "aaf30101-0082-931f-645b-08de9a26dddd",
    "cardId": "bf4c4dd6-5fb4-4ab9-ba6b-ba7604a3fc5c",
    "status": "Reversal",
    "statusText": "Completed",
    "merchant": "starbucks",
    "accountAmount": 873.57,
    "accountCurrency": "GBP",
    "transactionAmount": 873.57,
    "transactionCurrency": "GBP",
    "amount": 873.57,
    "transactionCurrencyCode": "GBP",
    "createdAt": "2026-04-14T13:08:05.49Z",
    "declineReason": null,
    "authorizationId": "a9f30101-0082-931f-6aeb-08de9a26b8cd"
  }
}