Sent when a card’s lifecycle status changes (e.g. activation, block, cancellation, expiry). Carries the same trimmed card object as NEW_CARD_ADDED, with the updated status. All deliveries share the common envelope (eventId, eventName, timestamp, programId, sandbox, customerId, clientReference).

card fields

nickName and limitGroupId are included only when set.
FieldTypeNotes
cardIdstringThe card identifier.
accountIdstringAccount the card is attached to.
maskedPanstringMasked card number.
cardTypestringe.g. VIRTUAL, PHYSICAL.
currencystringCard currency.
statusstringACTIVE, CREATED, BLOCKED, CANCELLED, EXPIRED.
nickNamestringOptional. Customer-set label.
limitGroupIdstringOptional. Spend-limit group.

Example

{
  "eventId": "c9f2…",
  "eventName": "CARD_STATUS_UPDATE",
  "timestamp": "2026-06-23T12:34:56.789Z",
  "programId": "yourprogram",
  "sandbox": false,
  "customerId": "cust_123",
  "card": {
    "cardId": "card_789",
    "accountId": "acc_456",
    "maskedPan": "528211******1234",
    "cardType": "VIRTUAL",
    "currency": "EUR",
    "status": "ACTIVE",
    "nickName": "Travel card",
    "limitGroupId": "lg_1"
  }
}