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

Account Tokens v2

Account tokens are single-use tokens which tokenize company/individual/business information, and are used for creating or updating an Account.

Learn more about calling API v2 endpoints.
Endpoints

The Account Token object 

Attributes

  • idstring

    Unique identifier for the token.

  • objectstring, value is "v2.core.account_token"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • createdtimestamp

    Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • expires_attimestamp

    Time at which the token will expire.

  • livemodeboolean

    Has the value true if the token exists in live mode or the value false if the object exists in test mode.

  • usedboolean

    Determines if the token has already been used (tokens can only be used once).

The Account Token object
{
  "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY",
  "object": "v2.core.account_token",
  "created": "2025-11-17T14:00:00.000Z",
  "expires_at": "2025-11-17T14:10:00.000Z",
  "livemode": true,
  "used": false
}

Create an account token v2

Creates an Account Token.

Learn more about calling API v2 endpoints.

Parameters

  • contact_emailstring

    The default contact email address for the Account. Required when configuring the account as a merchant or recipient.

  • display_namestring

    A descriptive name for the Account. This name will be surfaced in the Stripe Dashboard and on any invoices sent to the Account.

  • identityobject

    Information about the company, individual, and business represented by the Account.

Returns

Response attributes

  • idstring

    Unique identifier for the token.

  • objectstring, value is "v2.core.account_token"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • createdtimestamp

    Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • expires_attimestamp

    Time at which the token will expire.

  • livemodeboolean

    Has the value true if the token exists in live mode or the value false if the object exists in test mode.

  • usedboolean

    Determines if the token has already been used (tokens can only be used once).

Error Codes
400token_must_be_created_with_publishable_key

Token must be created with publishable key.

429account_rate_limit_exceeded

Account cannot exceed a configured concurrency rate limit on updates.

POST /v2/core/account_tokens
curl -X POST https://api.stripe.com/v2/core/account_tokens \
  -H "Authorization: Bearer sk_test_Ou1w6LV...ipDVJsvMeQscsk_test_Ou1w6LVt3zmVipDVJsvMeQsc" \
  -H "Stripe-Version: 2025-12-15.preview" \
  --json '{
    "contact_email": "[email protected]",
    "display_name": "Furever",
    "identity": {
        "attestations": {
            "terms_of_service": {
                "account": {
                    "shown_and_accepted": true
                }
            }
        },
        "entity_type": "company",
        "business_details": {
            "registered_name": "Furever"
        }
    }
  }'
Response
{
  "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY",
  "object": "v2.core.account_token",
  "created": "2025-11-17T14:00:00.000Z",
  "expires_at": "2025-11-17T14:10:00.000Z",
  "livemode": true,
  "used": false
}

Retrieve an account token v2

Retrieves an Account Token.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    The ID of the Account Token to retrieve.

Returns

Response attributes

  • idstring

    Unique identifier for the token.

  • objectstring, value is "v2.core.account_token"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • createdtimestamp

    Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • expires_attimestamp

    Time at which the token will expire.

  • livemodeboolean

    Has the value true if the token exists in live mode or the value false if the object exists in test mode.

  • usedboolean

    Determines if the token has already been used (tokens can only be used once).

Error Codes
404not_found

The resource wasn’t found.

429account_rate_limit_exceeded

Account cannot exceed a configured concurrency rate limit on updates.

GET /v2/core/account_tokens/:id
curl https://api.stripe.com/v2/core/account_tokens/accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY \
  -H "Authorization: Bearer sk_test_Ou1w6LV...ipDVJsvMeQscsk_test_Ou1w6LVt3zmVipDVJsvMeQsc" \
  -H "Stripe-Version: 2025-12-15.preview"
Response
{
  "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY",
  "object": "v2.core.account_token",
  "created": "2025-11-17T14:00:00.000Z",
  "expires_at": "2025-11-17T14:10:00.000Z",
  "livemode": true,
  "used": true
}