UPP Docs
Card

Card balance returned after termination

Sent once per card when the balance the issuer returns after termination is credited to the merchant's available balance, including when nothing is returned. data has the same shape as GET /cards/{cardId}; data.returned_balance is the returned amount and data.balance_return_transaction_id is the card_refund transaction that credited it (null when nothing is returned). It may arrive before or after the card.status_changed that marks the card terminated.

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.balance_returned
Request Body
application/json
{  "id": "evt_01m6b2k9x4q7w3e5r8t1y6u0pz",  "type": "card.balance_returned",  "created_at": "2026-11-01T03:20:11.000000Z",  "data": {    "id": "card_01m5ebk3ha6151ngyb1nahm2pn",    "card_product_id": "cpd_01JBXA3M6N8Q2R4T6V8W0Y2Z4A",    "application_id": "cap_01m5ebk2y3q8w4e5r6t7y8u9i0",    "order_no": "ORDER-1",    "cardholder_id": null,    "customer_id": "cus_01m5ead2k7knsqfa65tpt1an6r",    "currency": "USD",    "status": "terminated",    "created_at": "2026-10-21T04:30:26.000000Z",    "updated_at": "2026-11-01T03:20:11.000000Z",    "balance": "0.00",    "synced_at": "2026-11-01T03:18:40.000000Z",    "returned_balance": "25.50",    "balance_returned_at": "2026-11-01T03:20:11.000000Z",    "balance_return_transaction_id": "txn_01m6b2k9w8e5r4t3y2u1i0o9pa"  }}