Sample - Stripe API
POST/v1/issuing/tokens/{token}

Update an issuing token status

Updates the status of an Issuing token. Supply status to select the token state, and use expand when the response should include expanded fields.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 2 body fields
tokenstringrequired
The unique identifier of the Issuing token to update. Must not exceed 5000 characters.

Token status update parameters.

expandarray<string>optional
Specifies which fields in the response should be expanded.
statusstringrequired
Specifies which status the token should be updated to.
Allowed:activedeletedsuspended

2 status codes
200Returns the updated Issuing token containing its card, network, resulting status, timestamps, and token details.
cardstringrequired
Card associated with this token.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
device_fingerprintstringoptional
The hashed ID derived from the device ID from the card network associated with the token.
idstringrequired
Unique identifier for the object.
last4stringoptional
The last four digits of the token.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
networkstringrequired
The token service provider / card network associated with the token.
Allowed:mastercardvisa
network_dataobjectoptional
network_updated_atintegerrequired
Time at which the token was last updated by the card network. Measured in seconds since the Unix epoch.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.token
statusstringrequired
The usage state of the token.
Allowed:activedeletedrequestedsuspended
wallet_providerstringoptional
The digital wallet for this token, if one was used.
Allowed:apple_paygoogle_paysamsung_pay
defaultError response.
errorobjectrequired

Error handling

token must identify the token to update and must not exceed 5000 characters. status is required and must be one of active, deleted, or suspended; each expand value must be a string of no more than 5000 characters.