Change the status of a token
Change token status
Change the status of a token linked to a card. This endpoint allows you to manage the lifecycle of an individual token when more granular control is required.
The tokenId value uniquely identifies the token to update and can be retrieved from the Get tokens endpoint.
This functionality is supported for both Mastercard and Visa tokens.
By default, token status follows card status changes. This endpoint does not replace that default behaviour. Instead, it allows you to explicitly manage a specific token when needed, independently of card status updates.
Typical use cases
Temporary block of a single token
A cardholder reports a device issue, but the card itself should remain active. You can suspend the affected token without blocking the entire card or other tokens. Once resolved, the same token can be resumed.
Correcting a token status inconsistency
In some situations, a token may remain inactive or suspended due to a prior event, technical issue, or external update. You can explicitly activate or resume the token to restore its usability without changing the card status.
Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Path Parameters
The token id to update. You can retrieve this value from the Get tokens endpoint.
The action to perform on the token
activate, deactivate, suspend, resume Query Parameters
The audit user to log the request
Response
Token status updated successfully
Status of the token after the operation

