CardTransactionApproved

📘

Part of these flows

This webhook fires in all three flows: Authorization flow, Reversal flow, and Refund flow — approval is the step common to each of them.

Triggered when a card transaction authorization is approved and a transaction is created. After authorization is approved, the transaction is first created in a Pending state. If processing completes successfully, the transaction status changes to Approved.

The Approved status is the point at which the amount is held/debited from the cardholder balance on Altery's side — this is a notification, not an instruction. Transaction details may later appear again in clearing events. Use clearing events for reconciliation and confirmation of the final transaction details.

Amount fields

The payload carries two amount/currency pairs:

• accountAmount / accountCurrency — the amount held against the cardholder balance at the moment of approval, in the card account currency. It may still change later: settlement (CardTransactionCleared) can be for a smaller or larger amount, and the transaction can still be reversed or refunded — see Non-Standard Transaction Scenarios.
• transactionAmount / transactionCurrency — the amount in the original transaction currency, as charged at the merchant.

{
  "userId": "97e68444-8695-4aaf-ab5b-fdf92b0db27f",
  "event": "CardTransactionApproved",
  "transaction": {
    "transactionId": "cf680001-005c-d9c5-27d3-08de9a27032f",
    "cardId": "7df14c62-c1f6-4043-aabb-450b7e0779bf",
    "status": "Succeeded",
    "statusText": "Pending",
    "merchant": "starbucks",
    "accountAmount": 348.06,
    "accountCurrency": "GBP",
    "transactionAmount": 391.25,
    "transactionCurrency": "EUR",
    "amount": 348.06,
    "transactionCurrencyCode": "GBP",
    "createdAt": "2026-04-14T13:09:08.273Z",
    "declineReason": null,
    "authorizationId": "cf680001-005c-d9c5-27d3-08de9a27032f"
  }
}