Card payment transaction webhook

UR sends transaction_v2 when a card payment transaction reaches a terminal state; card payment records use data.type MARQETA_AUTHORIZE and the same event covers successful and failed payments. UR signs the raw body with EIP-191 (X-Api-Signature); the partner must verify the signer against UR's public key before acting. Return HTTP 200 within 10 seconds; UR retries non-200 or timed-out deliveries up to 3 times at 5-minute intervals, and data.id is the idempotency key.

Payload

Webhook envelope for post-swipe card payment transactions. UR signs the raw body with EIP-191; verify the recovered signer against UR's public key before acting on the payload.

eventconst: transaction_v2Required

Always transaction_v2.

timestampinteger · int64Required

Unix seconds when the event was emitted.

Responses

200

Return HTTP 200 within 10 seconds to acknowledge delivery.

No content

Payload

{
  "event": "transaction_v2",
  "data": {
    "id": 353244,
    "txHash": "0x30e3...",
    "blockNumber": 39376686,
    "createTimeE9": 1780298041358000000,
    "broadcastTimeE9": 1780298041358000000,
    "finalTimeE9": 1780298045000000000,
    "type": "MARQETA_AUTHORIZE",
    "chainId": "eip155:5003",
    "chainName": "MNT",
    "urId": "6570621322",
    "direction": "OUT",
    "amount": "0.06",
    "currency": "usd",
    "status": "CONFIRMED",
    "detailsJson": "{\"authorizationId\":\"card-auth-0001\",\"balance\":\"12360572.18\",\"cardCurrency\":\"USD\",\"cardId\":\"card-id-0001\",\"city\":\"Singapore\",\"country\":\"SGP\",\"mcc\":\"7299\",\"merchant\":\"Merchant ABC\",\"merchantId\":\"merchant-0001\",\"settlementAmount\":\"0.06\",\"settlementCurrency\":\"EUR\",\"transactionAmount\":\"0.06\",\"transactionCurrency\":\"USD\"}"
  },
  "timestamp": 1780298051
}