Create a person token 

Core Resources
Tokens
Create a person token

Creates a single-use token that represents the details for a person. Use this when you create or update persons associated with a Connect account. Learn more about account tokens.

You can only create person tokens with your application’s publishable key and in live mode. You can use your application’s secret key to create person tokens only in test mode.

Parameters

  • personobjectRequired

    Information for the person this token represents.

    • person.additional_tos_acceptancesobject

      Details on the legal guardian’s or authorizer’s acceptance of the required Stripe agreements.

      • person.additional_tos_acceptances.accountobject

        Details on the legal guardian’s acceptance of the main Stripe service agreement.

        • person.additional_tos_acceptances.account.datetimestampRequired if ip or user_agent is provided

          The Unix timestamp marking when the account representative accepted the service agreement.

        • person.additional_tos_acceptances.account.ipstringRequired if date or user_agent is provided

          The IP address from which the account representative accepted the service agreement.

        • person.additional_tos_acceptances.account.user_agentstring

          The user agent of the browser from which the account representative accepted the service agreement.

    • person.addressobject

      The person’s address.

      • person.address.citystring

        City, district, suburb, town, or village.

      • person.address.countrystring

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

      • person.address.line1string

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

      • person.address.line2string

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

      • person.address.postal_codestring

        ZIP or postal code.

      • person.address.statestring

        State, county, province, or region.

    • person.address_kanaobject

      The Kana variation of the person’s address (Japan only).

      • person.address_kana.citystring

        City or ward.

      • person.address_kana.countrystring

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

      • person.address_kana.line1string

        Block or building number.

      • person.address_kana.line2string

        Building details.

      • person.address_kana.postal_codestring

        Postal code.

      • person.address_kana.statestring

        Prefecture.

      • person.address_kana.townstring

        Town or cho-me.

    • person.address_kanjiobject

      The Kanji variation of the person’s address (Japan only).

      • person.address_kanji.citystring

        City or ward.

      • person.address_kanji.countrystring

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

      • person.address_kanji.line1string

        Block or building number.

      • person.address_kanji.line2string

        Building details.

      • person.address_kanji.postal_codestring

        Postal code.

      • person.address_kanji.statestring

        Prefecture.

      • person.address_kanji.townstring

        Town or cho-me.

    • person.dobobject

      The person’s date of birth.

      • person.dob.dayintegerRequired

        The day of birth, between 1 and 31.

      • person.dob.monthintegerRequired

        The month of birth, between 1 and 12.

      • person.dob.yearintegerRequired

        The four-digit year of birth.

    • person.documentsobject

      Documents that may be submitted to satisfy various informational requests.

      • person.documents.company_authorizationobject

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

        • person.documents.company_authorization.filesarray of strings

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

      • person.documents.passportobject

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

        • person.documents.passport.filesarray of strings

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

      • person.documents.visaobject

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

        • person.documents.visa.filesarray of strings

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

    • person.emailstring

      The person’s email address.

    • person.first_namestring

      The person’s first name.

    • person.first_name_kanastring

      The Kana variation of the person’s first name (Japan only).

    • person.first_name_kanjistring

      The Kanji variation of the person’s first name (Japan only).

    • person.full_name_aliasesarray of strings

      A list of alternate names or aliases that the person is known by.

    • person.genderenum

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

    • person.id_numberstring

      The person’s ID number, as appropriate for their country. For example, a social security number in the U.S., social insurance number in Canada, etc. Instead of the number itself, you can also provide a PII token provided by Stripe.js.

    • person.id_number_secondarystring

      The person’s secondary ID number, as appropriate for their 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 provided by Stripe.js.

    • person.last_namestring

      The person’s last name.

    • person.last_name_kanastring

      The Kana variation of the person’s last name (Japan only).

    • person.last_name_kanjistring

      The Kanji variation of the person’s last name (Japan only).

    • person.maiden_namestring

      The person’s maiden name.

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

    • person.nationalitystring

      The country where the person is a national. Two-letter country code (ISO 3166-1 alpha-2), or “XX” if unavailable.

    • person.phonestring

      The person’s phone number.

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

    • person.registered_addressobject

      The person’s registered address.

      • person.registered_address.citystring

        City, district, suburb, town, or village.

      • person.registered_address.countrystring

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

      • person.registered_address.line1string

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

      • person.registered_address.line2string

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

      • person.registered_address.postal_codestring

        ZIP or postal code.

      • person.registered_address.statestring

        State, county, province, or region.

    • person.relationshipobject

      The relationship that this person has with the account’s legal entity.

      • person.relationship.authorizerboolean

        Whether the person is the authorizer of the account’s representative.

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

      • person.relationship.executiveboolean

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

      • person.relationship.legal_guardianboolean

        Whether the person is the legal guardian of the account’s representative.

      • person.relationship.ownerboolean

        Whether the person is an owner of the account’s legal entity.

      • person.relationship.percent_ownershipfloat

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

      • person.relationship.representativeboolean

        Whether the person is authorized as the primary representative of the account. This is the person nominated by the business to provide information about themselves, and general information about the account. There can only be one representative at any given time. At the time the account is created, this person should be set to the person responsible for opening the account.

      • person.relationship.titlestring

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

    • person.ssn_last_4string

      The last four digits of the person’s Social Security number (U.S. only).

    • person.us_cfpb_dataobject

      Demographic data related to the person.

      • person.us_cfpb_data.ethnicity_detailsobject

        The persons ethnicity details

        • person.us_cfpb_data.ethnicity_details.ethnicityarray of enums

          The persons ethnicity

        • person.us_cfpb_data.ethnicity_details.ethnicity_otherstring

          Please specify your origin, when other is selected.

      • person.us_cfpb_data.race_detailsobject

        The persons race details

        • person.us_cfpb_data.race_details.racearray of enums

          The persons race.

        • person.us_cfpb_data.race_details.race_otherstring

          Please specify your race, when other is selected.

      • person.us_cfpb_data.self_identified_genderstring

        The persons self-identified gender

    • person.verificationobject

      The person’s verification status.

      • person.verification.additional_documentobject

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

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

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

      • person.verification.documentobject

        An identifying document, either a passport or local ID card.

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

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

Returns

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

POST /v1/tokens
curl https://api.stripe.com/v1/tokens \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d "person[first_name]"=Jane \
-d "person[last_name]"=Doe \
-d "person[relationship][owner]"=true
Response
{
"id": "cpt_1EDww82eZvKYlo2CsdelTHFu",
"object": "token",
"client_ip": "8.21.168.117",
"created": 1552582904,
"livemode": false,
"redaction": null,
"type": "person",
"used": false
}