API Reference
Open a StraitsX AccountContact Sales

Update Card Token Status

put
https://merchant.cop-staging.straitsx.com/api/v1/issuing_plans//users//cards//card_numbers//tokens//status

Change token status of a card

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

The status of a card is tied with status of a token

  • When a card is temporarily suspended from active state, all tokens associated with that card will be suspended as well. Token that is associated with temporarily suspended card can't be reactivated with this API. The API will return error XFC400007 Card is Inactive.
  • If a card is permanently blocked, all tokens associated with that card will be deleted and become unusable.

See Visa Card Tokenization documents for more information of the card status lifecycle.

Path Params
string
required

Issuing Plan Opaque ID

string
required

User Opaque ID

string
required

Card Opaque ID

string
required

Card Number Opaque ID

string
required

Card Token Opaque ID

Body Params
string
enum
required

oneof=ACTIVE SUSPENDED DEACTIVATED
For token in DEACTIVATED status, the status is permanent and cannot be updated anymore
For token in SUSPENDED status, it can be activated again after passing ACTIVE as the status

Allowed:
string
required

The reason of the card token status change

Responses

Updated about 2 months ago

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

Updated about 2 months ago