Create an Account Token v2

Core Resources
Account Tokens
Create an Account Token

Creates an Account Token.

Learn more about calling API v2 endpoints.

Parameters

  • identityobjectRequired

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

    • identity.attestationsobject

      Attestations from the identity’s key people, e.g. owners, executives, directors, representatives.

      • identity.attestations.directorship_declarationobject

        This hash is used to attest that the directors information provided to Stripe is both current and correct; IP, date, and User Agent are expanded by Stripe.

        • identity.attestations.directorship_declaration.attestedboolean

          A boolean indicating if the directors information has been attested.

      • identity.attestations.ownership_declarationobject

        This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct; IP, date, and User Agent are expanded by Stripe.

        • identity.attestations.ownership_declaration.attestedboolean

          A boolean indicating if the beneficial owner information has been attested.

      • identity.attestations.persons_providedobject

        Attestation that all Persons with a specific Relationship value have been provided.

        • identity.attestations.persons_provided.directorsboolean

          Whether the company’s directors have been provided. Set this Boolean to true after creating all the company’s directors with the Persons API.

        • identity.attestations.persons_provided.executivesboolean

          Whether the company’s executives have been provided. Set this Boolean to true after creating all the company’s executives with the Persons API.

        • identity.attestations.persons_provided.ownersboolean

          Whether the company’s owners have been provided. Set this Boolean to true after creating all the company’s owners with the Persons API.

        • identity.attestations.persons_provided.ownership_exemption_reasonenum

          Reason for why the company is exempt from providing ownership information.

          Possible enum values
          qualified_entity_exceeds_ownership_threshold

          A qualifying entity or group of qualifying entities own a significant enough share of the merchant’s business that they are exempt from providing ownership information based on regulatory guidelines in the merchant’s country.

          qualifies_as_financial_institution

          A merchant is a financial institution.

      • identity.attestations.representative_declarationobject

        This hash is used to attest that the representative is authorized to act as the representative of their legal entity; IP, date, and User Agent are expanded by Stripe.

        • identity.attestations.representative_declaration.attestedboolean

          A boolean indicating if the representative is authorized to act as the representative of their legal entity.

      • identity.attestations.terms_of_serviceobject

        Attestations of accepted terms of service agreements.

        • identity.attestations.terms_of_service.accountobject

          Details on the Account’s acceptance of the [Stripe Services Agreement]; IP, date, and User Agent are expanded by Stripe.

          • identity.attestations.terms_of_service.account.shown_and_acceptedboolean

            The boolean value indicating if the terms of service have been accepted.

        • identity.attestations.terms_of_service.storerobjectPreview feature

          Details on the Account’s acceptance of Treasury-specific terms of service; IP, date, and User Agent are expanded by Stripe.

          • identity.attestations.terms_of_service.storer.shown_and_acceptedboolean

            The boolean value indicating if the terms of service have been accepted.

    • identity.business_detailsobject

      Information about the company or business.

      • identity.business_details.addressobject

        The business registration address of the business entity.

        • identity.business_details.address.citystring

          City, district, suburb, town, or village.

        • identity.business_details.address.countryenum

          Two-letter country code (ISO 3166-1 alpha-2).

        • identity.business_details.address.line1string

          Address line 1 (e.g., street, PO Box, or company name).

        • identity.business_details.address.line2string

          Address line 2 (e.g., apartment, suite, unit, or building).

        • identity.business_details.address.postal_codestring

          ZIP or postal code.

        • identity.business_details.address.statestring

          State, county, province, or region.

        • identity.business_details.address.townstring

          Town or cho-me.

      • identity.business_details.annual_revenueobject

        The business gross annual revenue for its preceding fiscal year.

        • identity.business_details.annual_revenue.amountobject

          A non-negative integer representing the amount in the smallest currency unit.

          • identity.business_details.annual_revenue.amount.currencystringRequired

            A lowercase alpha3 currency code like “usd”.

          • identity.business_details.annual_revenue.amount.valueintegerRequired

            In minor units like 123 for 1.23 USD.

        • identity.business_details.annual_revenue.fiscal_year_endstring

          The close-out date of the preceding fiscal year in ISO 8601 format. E.g. 2023-12-31 for the 31st of December, 2023.

      • identity.business_details.documentsobject

        A document verifying the business.

        • identity.business_details.documents.bank_account_ownership_verificationobject

          One or more documents that support the bank account ownership verification requirement. Must be a document associated with the account’s primary active bank account that displays the last 4 digits of the account number, either a statement or a check.

          • identity.business_details.documents.bank_account_ownership_verification.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.bank_account_ownership_verification.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.company_licenseobject

          One or more documents that demonstrate proof of a company’s license to operate.

          • identity.business_details.documents.company_license.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.company_license.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.company_memorandum_of_associationobject

          One or more documents showing the company’s Memorandum of Association.

          • identity.business_details.documents.company_memorandum_of_association.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.company_memorandum_of_association.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.company_ministerial_decreeobject

          Certain countries only: One or more documents showing the ministerial decree legalizing the company’s establishment.

          • identity.business_details.documents.company_ministerial_decree.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.company_ministerial_decree.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.company_registration_verificationobject

          One or more documents that demonstrate proof of a company’s registration with the appropriate local authorities.

          • identity.business_details.documents.company_registration_verification.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.company_registration_verification.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.company_tax_id_verificationobject

          One or more documents that demonstrate proof of a company’s tax ID.

          • identity.business_details.documents.company_tax_id_verification.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.company_tax_id_verification.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.primary_verificationobject

          A document verifying the business.

          • identity.business_details.documents.primary_verification.front_backobjectRequired

            The file upload tokens referring to each side of the document.

            • identity.business_details.documents.primary_verification.front_back.backstring

              A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

            • identity.business_details.documents.primary_verification.front_back.frontstring

              A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

          • identity.business_details.documents.primary_verification.typeenumRequired

            The format of the verification document. Currently supports front_back only.

            Possible enum values
            front_back

            Document type with both front and back sides.

        • identity.business_details.documents.proof_of_addressobject

          One or more documents that demonstrate proof of address.

          • identity.business_details.documents.proof_of_address.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.proof_of_address.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.proof_of_registrationobject

          One or more documents showing the company’s proof of registration with the national business registry.

          • identity.business_details.documents.proof_of_registration.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.proof_of_registration.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.business_details.documents.proof_of_ultimate_beneficial_ownershipobject

          One or more documents that demonstrate proof of ultimate beneficial ownership.

          • identity.business_details.documents.proof_of_ultimate_beneficial_ownership.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.business_details.documents.proof_of_ultimate_beneficial_ownership.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

      • identity.business_details.estimated_worker_countinteger

        An estimated upper bound of employees, contractors, vendors, etc. currently working for the business.

      • identity.business_details.id_numbersarray of objects

        The ID numbers of a business entity.

        • identity.business_details.id_numbers.registrarstring

          The registrar of the ID number (Only valid for DE ID number types).

        • identity.business_details.id_numbers.typeenumRequired

          The ID number type of a business entity.

          Possible enum values
          ae_crn

          Company registration number - United Arab Emirates.

          ae_vat

          Business VAT ID - United Arab Emirates.

          ao_nif

          Número de Identificação Fiscal (NIF) - Angola.

          ar_cuit

          Clave Única de Identificación Tributaria - Argentina.

          at_fn

          Firmenbuchnummer - Austria.

          au_abn

          Australian Business Number - Australia.

          au_acn

          Australian Company Number - Australia.

          au_in

          Incorporation Number - Australia.

          az_tin

          Tax Identification Number - Azerbaijan.

          bd_etin

          Electronic Tax Identification Number (ETIN) - Bangladesh.

          Show 63 more
        • identity.business_details.id_numbers.valuestringRequired

          The value of the ID number.

      • identity.business_details.monthly_estimated_revenueobject

        An estimate of the monthly revenue of the business.

        • identity.business_details.monthly_estimated_revenue.amountobject

          A non-negative integer representing the amount in the smallest currency unit.

          • identity.business_details.monthly_estimated_revenue.amount.currencystringRequired

            A lowercase alpha3 currency code like “usd”.

          • identity.business_details.monthly_estimated_revenue.amount.valueintegerRequired

            In minor units like 123 for 1.23 USD.

      • identity.business_details.phonestring

        The phone number of the Business Entity.

      • identity.business_details.registered_namestring

        The business legal name.

      • identity.business_details.script_addressesobject

        The business registration address of the business entity in non latin script.

        • identity.business_details.script_addresses.kanaobject

          Kana Address.

          • identity.business_details.script_addresses.kana.citystring

            City, district, suburb, town, or village.

          • identity.business_details.script_addresses.kana.countryenum

            Two-letter country code (ISO 3166-1 alpha-2).

          • identity.business_details.script_addresses.kana.line1string

            Address line 1 (e.g., street, PO Box, or company name).

          • identity.business_details.script_addresses.kana.line2string

            Address line 2 (e.g., apartment, suite, unit, or building).

          • identity.business_details.script_addresses.kana.postal_codestring

            ZIP or postal code.

          • identity.business_details.script_addresses.kana.statestring

            State, county, province, or region.

          • identity.business_details.script_addresses.kana.townstring

            Town or cho-me.

        • identity.business_details.script_addresses.kanjiobject

          Kanji Address.

          • identity.business_details.script_addresses.kanji.citystring

            City, district, suburb, town, or village.

          • identity.business_details.script_addresses.kanji.countryenum

            Two-letter country code (ISO 3166-1 alpha-2).

          • identity.business_details.script_addresses.kanji.line1string

            Address line 1 (e.g., street, PO Box, or company name).

          • identity.business_details.script_addresses.kanji.line2string

            Address line 2 (e.g., apartment, suite, unit, or building).

          • identity.business_details.script_addresses.kanji.postal_codestring

            ZIP or postal code.

          • identity.business_details.script_addresses.kanji.statestring

            State, county, province, or region.

          • identity.business_details.script_addresses.kanji.townstring

            Town or cho-me.

      • identity.business_details.script_namesobject

        The business legal name in non latin script.

        • identity.business_details.script_names.kanaobject

          Kana name.

          • identity.business_details.script_names.kana.registered_namestring

            Registered name of the business.

        • identity.business_details.script_names.kanjiobject

          Kanji name.

          • identity.business_details.script_names.kanji.registered_namestring

            Registered name of the business.

      • identity.business_details.structureenum

        The category identifying the legal structure of the business.

        Possible enum values
        cooperative

        A cooperative organization.

        free_zone_establishment

        A free zone establishment.

        free_zone_llc

        A free zone LLC.

        government_instrumentality

        An organization formed by a government statute or body based in the US to perform a certain function, but not the actual government body itself.

        governmental_unit

        A branch of the state, local, or federal government of the US.

        incorporated_association

        An incorporated association.

        incorporated_non_profit

        An organization incorporated under the laws of a US state that has obtained tax-exempt status as a non-profit entity under either state or federal law (for example, 501©(3)).

        incorporated_partnership

        Also called ‘Limited Partnerships’ or ‘Registered Ordinary Partnerships’, these are businesses registered in Thailand owned by two or more people. The business’ legal entity and its legal personality is separated and distinct from the individual partners.

        limited_liability_partnership

        A limited liability partnership.

        llc

        An LLC.

        Show 17 more
    • identity.entity_typeenum

      The entity type.

      Possible enum values
      company

      A registered business.

      government_entity

      Government entity.

      individual

      An individual that is not registered as a business.

      non_profit

      A Non profit organization.

    • identity.individualobject

      Information about the person represented by the account.

      • identity.individual.additional_addressesarray of objects

        Additional addresses associated with the individual.

        • identity.individual.additional_addresses.citystring

          City, district, suburb, town, or village.

        • identity.individual.additional_addresses.countryenum

          Two-letter country code (ISO 3166-1 alpha-2).

        • identity.individual.additional_addresses.line1string

          Address line 1 (e.g., street, PO Box, or company name).

        • identity.individual.additional_addresses.line2string

          Address line 2 (e.g., apartment, suite, unit, or building).

        • identity.individual.additional_addresses.postal_codestring

          ZIP or postal code.

        • identity.individual.additional_addresses.purposeenumRequired

          Purpose of additional address.

          Possible enum values
          registered

          Registered.

        • identity.individual.additional_addresses.statestring

          State, county, province, or region.

        • identity.individual.additional_addresses.townstring

          Town or cho-me.

      • identity.individual.additional_namesarray of objects

        Additional names (e.g. aliases) associated with the individual.

        • identity.individual.additional_names.full_namestring

          The person’s full name.

        • identity.individual.additional_names.given_namestring

          The person’s first or given name.

        • identity.individual.additional_names.purposeenumRequired

          The purpose or type of the additional name.

          Possible enum values
          alias

          An alias for the individual’s name.

          maiden

          The maiden name of the individual.

        • identity.individual.additional_names.surnamestring

          The person’s last or family name.

      • identity.individual.addressobject

        The individual’s residential address.

        • identity.individual.address.citystring

          City, district, suburb, town, or village.

        • identity.individual.address.countryenum

          Two-letter country code (ISO 3166-1 alpha-2).

        • identity.individual.address.line1string

          Address line 1 (e.g., street, PO Box, or company name).

        • identity.individual.address.line2string

          Address line 2 (e.g., apartment, suite, unit, or building).

        • identity.individual.address.postal_codestring

          ZIP or postal code.

        • identity.individual.address.statestring

          State, county, province, or region.

        • identity.individual.address.townstring

          Town or cho-me.

      • identity.individual.date_of_birthobject

        The individual’s date of birth.

        • identity.individual.date_of_birth.dayintegerRequired

          The day of the birth.

        • identity.individual.date_of_birth.monthintegerRequired

          The month of birth.

        • identity.individual.date_of_birth.yearintegerRequired

          The year of birth.

      • identity.individual.documentsobject

        Documents that may be submitted to satisfy various informational requests.

        • identity.individual.documents.company_authorizationobject

          One or more documents that demonstrate proof that this person is authorized to represent the company.

          • identity.individual.documents.company_authorization.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.individual.documents.company_authorization.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.individual.documents.passportobject

          One or more documents showing the person’s passport page with photo and personal data.

          • identity.individual.documents.passport.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.individual.documents.passport.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

        • identity.individual.documents.primary_verificationobject

          An identifying document showing the person’s name, either a passport or local ID card.

          • identity.individual.documents.primary_verification.front_backobjectRequired

            The file upload tokens referring to each side of the document.

            • identity.individual.documents.primary_verification.front_back.backstring

              A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

            • identity.individual.documents.primary_verification.front_back.frontstring

              A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

          • identity.individual.documents.primary_verification.typeenumRequired

            The format of the verification document. Currently supports front_back only.

            Possible enum values
            front_back

            Document type with both front and back sides.

        • identity.individual.documents.secondary_verificationobject

          A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.

          • identity.individual.documents.secondary_verification.front_backobjectRequired

            The file upload tokens referring to each side of the document.

            • identity.individual.documents.secondary_verification.front_back.backstring

              A file upload token representing the back of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

            • identity.individual.documents.secondary_verification.front_back.frontstring

              A file upload token representing the front of the verification document. The purpose of the uploaded file should be ‘identity_document’. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

          • identity.individual.documents.secondary_verification.typeenumRequired

            The format of the verification document. Currently supports front_back only.

            Possible enum values
            front_back

            Document type with both front and back sides.

        • identity.individual.documents.visaobject

          One or more documents showing the person’s visa required for living in the country where they are residing.

          • identity.individual.documents.visa.filesarray of stringsRequired

            One or more document IDs returned by a file upload with a purpose value of account_requirement.

          • identity.individual.documents.visa.typeenumRequired

            The format of the document. Currently supports files only.

            Possible enum values
            files

            Document type with multiple files.

      • identity.individual.emailstring

        The individual’s email address.

      • identity.individual.given_namestring

        The individual’s first name.

      • identity.individual.id_numbersarray of objects

        The identification numbers (e.g., SSN) associated with the individual.

        • identity.individual.id_numbers.typeenumRequired

          The ID number type of an individual.

          Possible enum values
          ae_eid

          Emirates ID - United Arab Emirates.

          ao_nif

          Número de Identificação Fiscal (Tax Identification Number) - Angola.

          ar_dni

          Documento Nacional de Identidad (DNI) - Argentina.

          az_tin

          Tax Identification Number - Azerbaijan.

          bd_brc

          Birth Registration Certificate (BRC) - Bangladesh.

          bd_etin

          Electronic Tax Identification Number (ETIN) - Bangladesh.

          bd_nid

          National Identification Number (NID) - Bangladesh.

          br_cpf

          Cadastro de Pessoas Físicas - Brazil.

          cr_cpf

          Cédula de Persona Fisica (CPF) - Costa Rica.

          cr_dimex

          Documento de identificación Tributario Especial (DIMEX) - Costa Rica.

          Show 22 more
        • identity.individual.id_numbers.valuestringRequired

          The value of the ID number.

      • identity.individual.legal_genderenum

        The individual’s gender (International regulations require either “male” or “female”).

        Possible enum values
        female

        Female person gender.

        male

        Male person gender.

      • identity.individual.metadatamap

        Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

      • identity.individual.nationalitiesarray of enums

        The countries where the individual is a national. Two-letter country code (ISO 3166-1 alpha-2).

      • identity.individual.phonestring

        The individual’s phone number.

      • identity.individual.political_exposureenum

        The individual’s political exposure.

        Possible enum values
        existing

        The person has disclosed that they do have political exposure.

        none

        The person has disclosed that they have no political exposure.

      • identity.individual.relationshipobject

        The relationship that this individual has with the account’s identity.

        • identity.individual.relationship.directorboolean

          Whether the person is a director of the account’s identity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.

        • identity.individual.relationship.executiveboolean

          Whether the person has significant responsibility to control, manage, or direct the organization.

        • identity.individual.relationship.ownerboolean

          Whether the person is an owner of the account’s identity.

        • identity.individual.relationship.percent_ownershipdecimal

          The percent owned by the person of the account’s legal entity.

        • identity.individual.relationship.titlestring

          The person’s title (e.g., CEO, Support Engineer).

      • identity.individual.script_addressesobject

        The script addresses (e.g., non-Latin characters) associated with the individual.

        • identity.individual.script_addresses.kanaobject

          Kana Address.

          • identity.individual.script_addresses.kana.citystring

            City, district, suburb, town, or village.

          • identity.individual.script_addresses.kana.countryenum

            Two-letter country code (ISO 3166-1 alpha-2).

          • identity.individual.script_addresses.kana.line1string

            Address line 1 (e.g., street, PO Box, or company name).

          • identity.individual.script_addresses.kana.line2string

            Address line 2 (e.g., apartment, suite, unit, or building).

          • identity.individual.script_addresses.kana.postal_codestring

            ZIP or postal code.

          • identity.individual.script_addresses.kana.statestring

            State, county, province, or region.

          • identity.individual.script_addresses.kana.townstring

            Town or cho-me.

        • identity.individual.script_addresses.kanjiobject

          Kanji Address.

          • identity.individual.script_addresses.kanji.citystring

            City, district, suburb, town, or village.

          • identity.individual.script_addresses.kanji.countryenum

            Two-letter country code (ISO 3166-1 alpha-2).

          • identity.individual.script_addresses.kanji.line1string

            Address line 1 (e.g., street, PO Box, or company name).

          • identity.individual.script_addresses.kanji.line2string

            Address line 2 (e.g., apartment, suite, unit, or building).

          • identity.individual.script_addresses.kanji.postal_codestring

            ZIP or postal code.

          • identity.individual.script_addresses.kanji.statestring

            State, county, province, or region.

          • identity.individual.script_addresses.kanji.townstring

            Town or cho-me.

      • identity.individual.script_namesobject

        The individuals primary name in non latin script.

        • identity.individual.script_names.kanaobject

          Persons name in kana script.

          • identity.individual.script_names.kana.given_namestring

            The person’s first or given name.

          • identity.individual.script_names.kana.surnamestring

            The person’s last or family name.

        • identity.individual.script_names.kanjiobject

          Persons name in kanji script.

          • identity.individual.script_names.kanji.given_namestring

            The person’s first or given name.

          • identity.individual.script_names.kanji.surnamestring

            The person’s last or family name.

      • identity.individual.surnamestring

        The individual’s last name.

  • 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.

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.

POST /v2/core/account_tokens
curl -X POST https://api.stripe.com/v2/core/account_tokens \
-H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
-H "Stripe-Version: 2025-11-17.preview" \
--json '{
"contact_email": "furever@example.com",
"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
}