UPP Docs
Card

Card transaction recorded or status changed

Sent when a card transaction from the issuer is first recorded or its status moves forward (such as authorized → settled or settled → refunded). data is the same as GET /card-transactions/{transactionId}, plus previous_status (null for new transactions) and the event that triggered the notification. When only the amount or fees change and the status stays the same, card_transaction.updated is sent instead. Order notifications by data.id and event.revision; a lower revision arriving later can be ignored. A transaction can be authorized or refunded several times, so rely on the latest GET result.

Request Body

application/json
  1. body
id*string

Event ID (starts with evt_), unchanged across retries

type*string
created_at*string
Formatdate-time
data*

Response Body

Received by the merchant; any 2xx is a success

Example Requests
POST/card_transaction.status_changed
Request Body
application/json
{  "id": "evt_01m5pfa9f1k2q8w3z7x6c5v4bn",  "type": "card_transaction.status_changed",  "created_at": "2026-10-25T02:00:01.000000Z",  "data": {    "id": "ctx_01m5pfa9dwme84qyt826h2j818",    "card_id": "card_01m5nspbjc0ar8vsnxqc1e0wgp",    "original_transaction_id": null,    "type": "purchase",    "status": "settled",    "previous_status": "authorized",    "revision": 2,    "transaction_amount": "900.00",    "transaction_currency": "EUR",    "billing_currency": "USD",    "authorized_amount": "200.00",    "settled_amount": "1000.00",    "reversed_amount": "0.00",    "refunded_amount": "0.00",    "fee": "0.30",    "merchant": {      "name": "HOTEL",      "category_code": null,      "country": null,      "city": null    },    "authorization_code": null,    "wallet_type": null,    "description": "APPROVED",    "events": [      {        "id": "cte_01m5pf8x3qk7v2n9w4r6t1y8ze",        "type": "authorization",        "status": "authorized",        "revision": 1,        "transaction_amount": "180.00",        "transaction_currency": "EUR",        "billing_amount": "200.00",        "billing_currency": "USD",        "fee": "0.30",        "occurred_at": "2026-10-24T02:00:00.000000Z"      },      {        "id": "cte_01m5pfa9eak3m7q2x8c4v6b1nd",        "type": "settlement",        "status": "settled",        "revision": 2,        "transaction_amount": "900.00",        "transaction_currency": "EUR",        "billing_amount": "1000.00",        "billing_currency": "USD",        "fee": "0.00",        "occurred_at": "2026-10-25T02:00:00.000000Z"      }    ],    "event": {      "id": "cte_01m5pfa9eak3m7q2x8c4v6b1nd",      "type": "settlement",      "status": "settled",      "revision": 2,      "transaction_amount": "900.00",      "transaction_currency": "EUR",      "billing_amount": "1000.00",      "billing_currency": "USD",      "fee": "0.00",      "occurred_at": "2026-10-25T02:00:00.000000Z"    },    "occurred_at": "2026-10-24T02:00:00.000000Z",    "updated_at": "2026-10-25T02:00:01.000000Z"  }}

Card top-up or withdrawal concluded Webhook

Sent when a top-up or withdrawal succeeds (succeeded, booked) or fails (failed); data is the same as GET /card-fundings/…

Card transaction amount or fees changed Webhook

Sent when a card transaction's amount or fees change while its status stays the same, such as a fee merged into the purc…