Update Token Status

post

https://devapi.qolopay.com/api/{version}/cards/{card_proxy}/tokens/status

Update the status of a token based on card_proxy and token_guid.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

card_proxy

string

required

card_proxy

version

string

required

Body Params

TokenStatusRequest

Request DTO for changing token status

token_status

string

enum

required

Token status operation types

Allowed:

reason_code

string

enum

required

Reason codes for token lifecycle operations based on MDES specifications.
Different codes are valid for different operations (SUSPEND, UNSUSPEND, DELETE).

comment

string | null

Optional description providing additional context for the status change

delete_from_consumer_app

boolean | null

When true, indicates the token should also be deleted from the consumer's mobile app/wallet.
Only applicable when token_status is DELETE.

MDES Specification:

true: The token will be removed only from the device/token requestor but will remain active
on the MDES platform. Any historical payments (such as subscriptions) will continue to
be processed but no new payments will be possible as the token will have been removed
from the device/token requestor.
false: The token will be deleted from both the device/token requestor and the MDES platform.

token_guid

uuid

required

The unique identifier (GUID) for the token in the Qolo system.
This is a standardized internal representation that maps to the token_unique_reference
from both MDES (Mastercard) and VTS (Visa) token service providers.

Responses

500

Server Error

200Returns the updated token status

400Bad request

401Unauthorized

404Card not found