Set Card Status

The Set Card Status API will enable you to change the status of a specific card_id:

inactive: Default status for a new card (unless explicitly set to active or pending_auth). This status is modifiable to any status; it cannot be set back to inactive

pending_auth: Setting the status to pending_auth allows the card to be activated via POS or ATM transaction using the correct PIN. You can return a card to pending_auth at any time to give your Customers extra security - for example, ensuring a card cannot be used while traveling until the correct PIN is provided. This status is modifiable to any status other than inactive

active: Applied upon card creation or following successful customer authentication to enable full transaction usage. This status is modifiable to any status other than inactive

freeze: Applied when a Customer requests a temporary block on their card, for example, ensuring a card cannot be used while traveling. All subsequent authorization attempts are automatically declined. This status is modifiable and can be set back to active at the customer's request, or to active, administrative, destroyed, lost, stolen, or fraud by You

administrative: Applied when there are internal concerns regarding usage by the Customer or a third party. This status is modifiable and can be set back to active or transitioned to another status (e.g., destroyed, lost, stolen, or fraud). It must not be set as a result of a Customer request

destroyed: Where the card is no longer required. All future authorization requests will be declined. This status is permanent and cannot be reversed

lost: Applied when a customer reports a card as lost. All subsequent authorization attempts are automatically declined. This status cannot be reversed and can only be transitioned to fraud

stolen: Applied when a customer or third party confirms the card is stolen. Following this status update, all authorization attempts are automatically declined. This status cannot be reversed and can only be transitioned to fraud

fraud: Upon confirmed fraud, the card is permanently updated to fraud to block further misuse. This status cannot be changed or reversed

Status used by CLOWD9:

risk: When a CLOWD9 monitoring rule flags potential fraud requiring immediate investigation, subsequent authorizations are automatically declined. You will receive notification of this status via the Network Confirmation Message. This status can be updated upon request or transitioned to another state (e.g., active, destroyed, lost, stolen, or fraud)

expired: CLOWD9 sets the card status to expired when its expiry date passes, when a renewal or replacement card is activated, or when a physical card is activated following a virtual card conversion

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 36 and 36
^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

The Identifier associated to the Card

Body Params
string
required

The desired new status for the card. Use ListCardStatus.

string
Responses

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