Skip to main content

Card Transaction Event

Notifies your system whenever any transaction event occurs on a card, including:

  • Transaction creation
  • Transaction confirmation
  • Transaction clearing
  • Transaction status change

The payload structure is identical to the response of Retrieve Card Transaction Details.


Headers​

HeaderValue
api-notification-signSHA-512 signature of the request body
Content-Typeapplication/json

Payload example​

{
"id": "9f283e59-21ec-4c74-ae32-156d49cd9cf2",
"cardUuid": "019cd7a9-8482-708a-addc-63885bd9403c",
"accountUuid": "019d2236-2511-728e-96de-27fca03a9c48",
"amount": "50.00",
"currency": "USD",
"type": "purchase",
"status": "completed",
"merchantName": "Amazon",
"merchantCategory": "5411",
"createdAt": "2026-03-25T10:30:00+00:00",
"updatedAt": "2026-03-25T10:31:00+00:00"
}

Fields may include feeAmount, settlementAmount, settlementCurrency and other provider-specific fields — the full set matches the detail endpoint response.


Respond with 2xx​

Your endpoint must return an HTTP 2xx response. Failed deliveries are logged and visible in Webhook Event Log.