Card State Event

Notifies your system whenever a card is created or its status changes.

Possible status values: creating, active, frozen, closed, creating_failed.

The payload structure is identical to the response of Retrieve Card Details.

---

Headers

Header	Value
api-notification-sign	SHA-512 signature of the request body
Content-Type	application/json

---

Payload example

{
  "id": "019cd7a9-8482-708a-addc-63885bd9403c",
  "accountUuid": "019d2236-2511-728e-96de-27fca03a9c48",
  "cardOwnerId": "owner-12345",
  "status": "active",
  "cardType": "virtual",
  "lastFour": "2707",
  "balance": "50.00",
  "availableBalance": "50.00",
  "currency": "USD",
  "expiryMonth": 12,
  "expiryYear": 2028,
  "createdAt": "2026-03-24T15:46:40+00:00",
  "updatedAt": "2026-03-24T15:48:54+00:00"
}

Async card issuance

Use this event instead of polling to detect when a card transitions from creating to active or creating_failed.

---

Respond with 2xx

Your endpoint must return an HTTP 2xx response. Failed deliveries are logged and visible in Webhook Event Log.