Create an account token

Core Resources

Tokens

Creates a single-use token that wraps a user’s legal entity information. Use this when creating or updating a Connect account. Learn more about account tokens.

In live mode, you can only create account tokens with your application’s publishable key. In test mode, you can only create account tokens with your secret key or publishable key.

Parameters

accountobjectRequired
Information for the account this token represents.
- account.business_typeenum
  The business type.
  Possible enum values
  company
  government_entity
  US only
  individual
  non_profit
- account.companyobject
  Information about the company or business.
  account.company.addressobject
  The company’s primary address.
  account.company.address.citystring
  City, district, suburb, town, or village.
  account.company.address.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.company.address.line1string
  Address line 1 (e.g., street, PO Box, or company name).
  account.company.address.line2string
  Address line 2 (e.g., apartment, suite, unit, or building).
  account.company.address.postal_codestring
  ZIP or postal code.
  account.company.address.statestring
  State, county, province, or region.
  account.company.address_kanaobject
  The Kana variation of the company’s primary address (Japan only).
  account.company.address_kana.citystring
  City or ward.
  account.company.address_kana.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.company.address_kana.line1string
  Block or building number.
  account.company.address_kana.line2string
  Building details.
  account.company.address_kana.postal_codestring
  Postal code.
  account.company.address_kana.statestring
  Prefecture.
  account.company.address_kana.townstring
  Town or cho-me.
  account.company.address_kanjiobject
  The Kanji variation of the company’s primary address (Japan only).
  account.company.address_kanji.citystring
  City or ward.
  account.company.address_kanji.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.company.address_kanji.line1string
  Block or building number.
  account.company.address_kanji.line2string
  Building details.
  account.company.address_kanji.postal_codestring
  Postal code.
  account.company.address_kanji.statestring
  Prefecture.
  account.company.address_kanji.townstring
  Town or cho-me.
  account.company.directors_providedboolean
  Whether the company’s directors have been provided. Set this Boolean to true after creating all the company’s directors with the Persons API for accounts with a relationship.director requirement. This value is not automatically set to true after creating directors, so it needs to be updated to indicate all directors have been provided.
  account.company.directorship_declarationobject
  This hash is used to attest that the directors information provided to Stripe is both current and correct.
  account.company.directorship_declaration.datetimestamp
  The Unix timestamp marking when the directorship declaration attestation was made.
  account.company.directorship_declaration.ipstring
  The IP address from which the directorship declaration attestation was made.
  account.company.directorship_declaration.user_agentstring
  The user agent of the browser from which the directorship declaration attestation was made.
  account.company.executives_providedboolean
  Whether the company’s executives have been provided. Set this Boolean to true after creating all the company’s executives with the Persons API for accounts with a relationship.executive requirement.
  account.company.export_license_idstring
  The export license ID number of the company, also referred as Import Export Code (India only).
  account.company.export_purpose_codestring
  The purpose code to use for export transactions (India only).
  account.company.namestring
  The company’s legal name.
  account.company.name_kanastring
  The Kana variation of the company’s legal name (Japan only).
  account.company.name_kanjistring
  The Kanji variation of the company’s legal name (Japan only).
  account.company.owners_providedboolean
  Whether the company’s owners have been provided. Set this Boolean to true after creating all the company’s owners with the Persons API for accounts with a relationship.owner requirement.
  account.company.ownership_declarationobject
  This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.
  account.company.ownership_declaration.datetimestamp
  The Unix timestamp marking when the beneficial owner attestation was made.
  account.company.ownership_declaration.ipstring
  The IP address from which the beneficial owner attestation was made.
  account.company.ownership_declaration.user_agentstring
  The user agent of the browser from which the beneficial owner attestation was made.
  account.company.ownership_declaration_shown_and_signedboolean
  Whether the user described by the data in the token has been shown the Ownership Declaration and indicated that it is correct.
  account.company.ownership_exemption_reasonenum
  This value is used to determine if a business is exempt from providing ultimate beneficial owners. See this support article and changelog for more details.
  account.company.phonestring
  The company’s phone number (used for verification).
  account.company.registration_dateobject
  When the business was incorporated or registered.
  account.company.registration_date.dayintegerRequired
  The day of registration, between 1 and 31.
  account.company.registration_date.monthintegerRequired
  The month of registration, between 1 and 12.
  account.company.registration_date.yearintegerRequired
  The four-digit year of registration.
  account.company.registration_numberstring
  The identification number given to a company when it is registered or incorporated, if distinct from the identification number used for filing taxes. (Examples are the CIN for companies and LLP IN for partnerships in India, and the Company Registration Number in Hong Kong).
  account.company.structureenum
  The category identifying the legal structure of the company or legal entity. See Business structure for more details. Pass an empty string to unset this value.
  account.company.tax_idstring
  The business ID number of the company, as appropriate for the company’s country. (Examples are an Employer ID Number in the U.S., a Business Number in Canada, or a Company Number in the UK.)
  account.company.tax_id_registrarstring
  The jurisdiction in which the tax_id is registered (Germany-based companies only).
  account.company.vat_idstring
  The VAT number of the company.
  account.company.verificationobject
  Information on the verification state of the company.
  account.company.verification.documentobject
  A document verifying the business.
  account.company.verification.document.backstring
  The back of a document returned by a file upload with a purpose value of additional_verification. 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.
  account.company.verification.document.frontstring
  The front of a document returned by a file upload with a purpose value of additional_verification. 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.
- account.individualobject
  Information about the person represented by the account.
  account.individual.addressobject
  The individual’s primary address.
  account.individual.address.citystring
  City, district, suburb, town, or village.
  account.individual.address.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.individual.address.line1string
  Address line 1 (e.g., street, PO Box, or company name).
  account.individual.address.line2string
  Address line 2 (e.g., apartment, suite, unit, or building).
  account.individual.address.postal_codestring
  ZIP or postal code.
  account.individual.address.statestring
  State, county, province, or region.
  account.individual.address_kanaobject
  The Kana variation of the individual’s primary address (Japan only).
  account.individual.address_kana.citystring
  City or ward.
  account.individual.address_kana.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.individual.address_kana.line1string
  Block or building number.
  account.individual.address_kana.line2string
  Building details.
  account.individual.address_kana.postal_codestring
  Postal code.
  account.individual.address_kana.statestring
  Prefecture.
  account.individual.address_kana.townstring
  Town or cho-me.
  account.individual.address_kanjiobject
  The Kanji variation of the individual’s primary address (Japan only).
  account.individual.address_kanji.citystring
  City or ward.
  account.individual.address_kanji.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.individual.address_kanji.line1string
  Block or building number.
  account.individual.address_kanji.line2string
  Building details.
  account.individual.address_kanji.postal_codestring
  Postal code.
  account.individual.address_kanji.statestring
  Prefecture.
  account.individual.address_kanji.townstring
  Town or cho-me.
  account.individual.dobobject
  The individual’s date of birth.
  account.individual.dob.dayintegerRequired
  The day of birth, between 1 and 31.
  account.individual.dob.monthintegerRequired
  The month of birth, between 1 and 12.
  account.individual.dob.yearintegerRequired
  The four-digit year of birth.
  account.individual.emailstring
  The individual’s email address.
  account.individual.first_namestring
  The individual’s first name.
  account.individual.first_name_kanastring
  The Kana variation of the individual’s first name (Japan only).
  account.individual.first_name_kanjistring
  The Kanji variation of the individual’s first name (Japan only).
  account.individual.full_name_aliasesarray of strings
  A list of alternate names or aliases that the individual is known by.
  account.individual.genderenum
  The individual’s gender
  account.individual.id_numberstring
  The government-issued ID number of the individual, as appropriate for the representative’s country. (Examples are a Social Security Number in the U.S., or a Social Insurance Number in Canada). Instead of the number itself, you can also provide a PII token created with Stripe.js.
  account.individual.id_number_secondarystring
  The government-issued secondary ID number of the individual, as appropriate for the representative’s country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. Instead of the number itself, you can also provide a PII token created with Stripe.js.
  account.individual.last_namestring
  The individual’s last name.
  account.individual.last_name_kanastring
  The Kana variation of the individual’s last name (Japan only).
  account.individual.last_name_kanjistring
  The Kanji variation of the individual’s last name (Japan only).
  account.individual.maiden_namestring
  The individual’s maiden name.
  account.individual.metadataobject
  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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.
  account.individual.phonestring
  The individual’s phone number.
  account.individual.political_exposureenum
  Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
  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
  account.individual.registered_addressobject
  The individual’s registered address.
  account.individual.registered_address.citystring
  City, district, suburb, town, or village.
  account.individual.registered_address.countrystring
  Two-letter country code (ISO 3166-1 alpha-2).
  account.individual.registered_address.line1string
  Address line 1 (e.g., street, PO Box, or company name).
  account.individual.registered_address.line2string
  Address line 2 (e.g., apartment, suite, unit, or building).
  account.individual.registered_address.postal_codestring
  ZIP or postal code.
  account.individual.registered_address.statestring
  State, county, province, or region.
  account.individual.relationshipobject
  Describes the person’s relationship to the account.
  account.individual.relationship.directorboolean
  Whether the person is a director of the account’s legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
  account.individual.relationship.executiveboolean
  Whether the person has significant responsibility to control, manage, or direct the organization.
  account.individual.relationship.ownerboolean
  Whether the person is an owner of the account’s legal entity.
  account.individual.relationship.percent_ownershipfloat
  The percent owned by the person of the account’s legal entity.
  account.individual.relationship.titlestring
  The person’s title (e.g., CEO, Support Engineer).
  account.individual.ssn_last_4string
  The last four digits of the individual’s Social Security Number (U.S. only).
  account.individual.verificationobject
  The individual’s verification document information.
  account.individual.verification.additional_documentobject
  A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
  account.individual.verification.additional_document.backstring
  The back of an ID returned by a file upload with a purpose value of 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.
  account.individual.verification.additional_document.frontstring
  The front of an ID returned by a file upload with a purpose value of 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.
  account.individual.verification.documentobject
  An identifying document, either a passport or local ID card.
  account.individual.verification.document.backstring
  The back of an ID returned by a file upload with a purpose value of 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.
  account.individual.verification.document.frontstring
  The front of an ID returned by a file upload with a purpose value of 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.
- account.tos_shown_and_acceptedboolean
  Whether the user described by the data in the token has been shown the Stripe Connected Account Agreement. When creating an account token to create a new Connect account, this value must be true.

Returns

Returns the created account token if it’s successful. Otherwise, this call raises an error.

POST /v1/tokens

Server-side language

curl https://api.stripe.com/v1/tokens \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d "account[business_type]"=individual \
  -d "account[individual][first_name]"=Jane \
  -d "account[individual][last_name]"=Doe \
  -d "account[tos_shown_and_accepted]"=true

Response

{
  "id": "ct_1BZ6xr2eZvKYlo2CsSOhuTfi",
  "object": "token",
  "client_ip": "104.198.25.169",
  "created": 1513297331,
  "livemode": false,
  "redaction": null,
  "type": "account",
  "used": false
}

Create an account token

Parameters

accountobjectRequired

account.business_typeenum

account.companyobject

account.company.addressobject

account.company.address.citystring

account.company.address.countrystring

account.company.address.line1string

account.company.address.line2string

account.company.address.postal_codestring

account.company.address.statestring

account.company.address_kanaobject

account.company.address_kana.citystring

account.company.address_kana.countrystring

account.company.address_kana.line1string

account.company.address_kana.line2string

account.company.address_kana.postal_codestring

account.company.address_kana.statestring

account.company.address_kana.townstring

account.company.address_kanjiobject

account.company.address_kanji.citystring

account.company.address_kanji.countrystring

account.company.address_kanji.line1string

account.company.address_kanji.line2string

account.company.address_kanji.postal_codestring

account.company.address_kanji.statestring

account.company.address_kanji.townstring

account.company.directors_providedboolean

account.company.directorship_declarationobject

account.company.directorship_declaration.datetimestamp

account.company.directorship_declaration.ipstring

account.company.directorship_declaration.user_agentstring

account.company.executives_providedboolean

account.company.export_license_idstring

account.company.export_purpose_codestring

account.company.namestring

account.company.name_kanastring

account.company.name_kanjistring

account.company.owners_providedboolean

account.company.ownership_declarationobject

account.company.ownership_declaration.datetimestamp

account.company.ownership_declaration.ipstring

account.company.ownership_declaration.user_agentstring

account.company.ownership_declaration_shown_and_signedboolean

account.company.ownership_exemption_reasonenum

account.company.phonestring

account.company.registration_dateobject

account.company.registration_date.dayintegerRequired

account.company.registration_date.monthintegerRequired

account.company.registration_date.yearintegerRequired

account.company.registration_numberstring

account.company.structureenum

account.company.tax_idstring

account.company.tax_id_registrarstring

account.company.vat_idstring

account.company.verificationobject

account.company.verification.documentobject

account.company.verification.document.backstring

account.company.verification.document.frontstring

account.individualobject

account.individual.addressobject

account.individual.address.citystring

account.individual.address.countrystring

account.individual.address.line1string

account.individual.address.line2string

account.individual.address.postal_codestring

account.individual.address.statestring

account.individual.address_kanaobject

account.individual.address_kana.citystring

account.individual.address_kana.countrystring

account.individual.address_kana.line1string

account.individual.address_kana.line2string

account.individual.address_kana.postal_codestring

account.individual.address_kana.statestring

account.individual.address_kana.townstring

account.individual.address_kanjiobject

account.individual.address_kanji.citystring

account.individual.address_kanji.countrystring

account.individual.address_kanji.line1string