Card transaction reversal of partial cancellation

{ "id": "evt_019cbf61a2557aada6e82020cbe5021f", "type": "card.transaction.reversal_partial_cancellation", "createdAt": "2026-11-12T10:30:00Z", "data": { "id": "019cbf5b-e094-72aa-8c7d-92f7b1e3b204", "accountId": "019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f", "cardId": "019cbf5a-7688-7d52-a62b-f58c2907f332", "status": "pending", "amount": "750", "currency": "EUR", "decimals": 2, "originalAmount": "495", "originalCurrency": "USD", "originalDecimals": 2, "isCredit": false, "createdAt": "2026-11-12T10:10:00.123456789Z", "updatedAt": "2026-11-12T10:10:00.123456789Z", "description": "Coffee Shop", "authorizationId": 42001, "authorizationCode": "123456", "merchant": { "name": "Coffee Shop", "city": "London", "country": "GB", "categoryCode": "5814" }, "entryMode": "051", "country": null, "billing": { "billingAmount": "750", "billingCurrency": { "symbol": "€", "code": "EUR", "decimals": 2, "name": "Euro" } }, "transactionCurrency": { "symbol": "$", "code": "USD", "decimals": 2, "name": "US Dollar" }, "cardToken": null, "wallet": null, "clearedAt": null, "isPending": true, "kind": "payment", "transactionType": "051", "transactions": [], "declineReason": null, "enrichment": null, "visaTransactionCode": null } }

Headers

X-Webhook-Timestamp

string

required

Time of the delivery as a Unix timestamp in seconds. The signed payload includes this value.

X-Webhook-Signature

string

required

Base64-encoded Ed25519 signature of {X-Webhook-Timestamp}.{raw body}.

Body

application/json

The event.

Envelope of each webhook event.

string

required

Unique identifier of the event. Each retry of a delivery has the same id. Use the id to process each event only one time.

type

enum<string>

required

Type of the event.

Available options:

card.transaction.reversal_partial_cancellation

createdAt

string<date-time>

required

Time of the event.

data

object

required

Payload of the event.

Show child attributes

Example:

{
  "id": "019cbf5b-e094-72aa-8c7d-92f7b1e3b204",
  "accountId": "019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f",
  "cardId": "019cbf5a-7688-7d52-a62b-f58c2907f332",
  "status": "pending",
  "amount": "750",
  "currency": "EUR",
  "decimals": 2,
  "originalAmount": "495",
  "originalCurrency": "USD",
  "originalDecimals": 2,
  "isCredit": false,
  "createdAt": "2026-11-12T10:10:00.123456789Z",
  "updatedAt": "2026-11-12T10:10:00.123456789Z",
  "description": "Coffee Shop",
  "authorizationId": 42001,
  "authorizationCode": "123456",
  "merchant": {
    "name": "Coffee Shop",
    "city": "London",
    "country": "GB",
    "categoryCode": "5814"
  },
  "entryMode": "051",
  "country": null,
  "billing": {
    "billingAmount": "750",
    "billingCurrency": {
      "symbol": "€",
      "code": "EUR",
      "decimals": 2,
      "name": "Euro"
    }
  },
  "transactionCurrency": {
    "symbol": "$",
    "code": "USD",
    "decimals": 2,
    "name": "US Dollar"
  },
  "cardToken": null,
  "wallet": null,
  "clearedAt": null,
  "isPending": true,
  "kind": "payment",
  "transactionType": "051",
  "transactions": [],
  "declineReason": null,
  "enrichment": null,
  "visaTransactionCode": null
}

Response

2XX

To acknowledge the event, return a 2xx status.