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
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||