Update Card Status

Change a card's status, applicable to SINGLE and SHARE mode cards.

The final status change of the card shall be subject to webhooks notification.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Universally unique identifier (UUID v4) of a resource.

Body Params
string
enum
required

Card status enum. See the Card lifecycle and statuses guide for more information.

  • ACTIVE - The request to create the card was successful and the card is ready to use.
  • FROZEN - All incoming authorization requests will be declined. the card can be reactivated to accept new authorizations.
  • CANCELLED - The card cannot be reactivated from this state, all incoming authorization requests will be permanently declined.
Allowed:
string
length between 0 and 100

The reason for updating card status.

Headers
string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

uuid
required

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json