Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Payment Records
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Webhooks

Update a token status 

Issuing
Tokens
Update a token status

Attempts to update the specified Issuing Token object to the status specified.

Parameters

  • statusenumRequired

    Specifies which status the token should be updated to.

    Possible enum values
    active

    Token is provisioned and usable for payments.

    deleted

    Terminal state. Token can no longer be used.

    suspended

    Token temporarily cannot be used for payments.

Returns

Returns an updated Issuing Token object if a valid identifier was provided.

POST /v1/issuing/tokens/:id
curl https://api.stripe.com/v1/issuing/tokens/intok_1MzDbE2eZvKYlo2C26a98MDg \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d status=suspended
Response
{
  "id": "intok_1MzDbE2eZvKYlo2C26a98MDg",
  "object": "issuing.token",
  "card": "ic_1MytUz2eZvKYlo2CZCn5fuvZ",
  "created": 1682059060,
  "network_updated_at": 1682059060,
  "livemode": false,
  "status": "suspended",
  "last4": "2424",
  "token_service_provider": "visa",
  "wallet_provider": "apple_pay",
  "device_fingerprint": "intd_1MzDbE2eZvKYcp3095svdf"
}