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

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"
}

Retrieve an issuing token 

Retrieves an Issuing Token object.

Parameters

No parameters.

Returns

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

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

List all issuing tokens for card 

Lists all Issuing Token objects for a given card.

Parameters

  • cardstringRequired

    The Issuing card identifier to list tokens for.

  • createdobject

    Only return Issuing tokens that were created during the given date interval.

  • statusenum

    Select Issuing tokens with the given status.

    Possible enum values
    active

    Token is provisioned and usable for payments.

    deleted

    Terminal state. Token can no longer be used.

    requested

    Token has been requested to be provisioned, but has not completed the activation process.

    suspended

    Token temporarily cannot be used for payments.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit tokens, starting after token starting_after. Each entry in the array is a separate Issuing Token object. If no more tokens are available, the resulting array will be empty.

GET /v1/issuing/tokens
curl -G https://api.stripe.com/v1/issuing/tokens \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3 \
  -d card=ic_1MytUz2eZvKYlo2CZCn5fuvZ
Response
{
  "object": "list",
  "url": "/v1/issuing/tokens",
  "has_more": false,
  "data": [
    {
      "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"
    }
  ]
}

Transactions 

Any use of an issued card that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing Transaction object.

Related guide: Issued card transactions

Endpoints

Connection Token 

A Connection Token is used by the Stripe Terminal SDK to connect to a reader.

Related guide: Fleet management

Endpoints