Defines the object schema located at components.schemas.person in the specification.
This is an object representing a person associated with a Stripe account.
A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. See the Standard onboarding or Express onboarding documentation for information about platform pre-filling and account onboarding steps.
Related guide: Handling Identity Verification with the API.
Constructors
PersonpersonAccount :: Textaccount: The account the person is associated with.
Constraints:
Maximum length of 5000
personAddress :: Maybe Addressaddress:
personAddressKana :: Maybe (Nullable PersonAddressKana'NonNullable)address_kana
personAddressKanji :: Maybe (Nullable PersonAddressKanji'NonNullable)address_kanji
personCreated :: Intcreated: Time at which the object was created. Measured in seconds since the Unix epoch.
personDob :: Maybe LegalEntityDobdob:
personEmail :: Maybe (Nullable Text)email: The person's email address.
Constraints:
Maximum length of 5000
personFirstName :: Maybe (Nullable Text)first_name: The person's first name.
Constraints:
Maximum length of 5000
personFirstNameKana :: Maybe (Nullable Text)first_name_kana: The Kana variation of the person's first name (Japan only).
Constraints:
Maximum length of 5000
personFirstNameKanji :: Maybe (Nullable Text)first_name_kanji: The Kanji variation of the person's first name (Japan only).
Constraints:
Maximum length of 5000
personFullNameAliases :: Maybe [Text]full_name_aliases: A list of alternate names or aliases that the person is known by.
personFutureRequirements :: Maybe (Nullable PersonFutureRequirements'NonNullable)future_requirements
personGender :: Maybe (Nullable Text)gender: The person's gender (International regulations require either "male" or "female").
personId :: Textid: Unique identifier for the object.
Constraints:
Maximum length of 5000
personIdNumberProvided :: Maybe Boolid_number_provided: Whether the person's `id_number` was provided.
personIdNumberSecondaryProvided :: Maybe Boolid_number_secondary_provided: Whether the person's `id_number_secondary` was provided.
personLastName :: Maybe (Nullable Text)last_name: The person's last name.
Constraints:
Maximum length of 5000
personLastNameKana :: Maybe (Nullable Text)last_name_kana: The Kana variation of the person's last name (Japan only).
Constraints:
Maximum length of 5000
personLastNameKanji :: Maybe (Nullable Text)last_name_kanji: The Kanji variation of the person's last name (Japan only).
Constraints:
Maximum length of 5000
personMaidenName :: Maybe (Nullable Text)maiden_name: The person's maiden name.
Constraints:
Maximum length of 5000
personMetadata :: Maybe Objectmetadata: 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.
personNationality :: Maybe (Nullable Text)nationality: The country where the person is a national.
Constraints:
Maximum length of 5000
personPhone :: Maybe (Nullable Text)phone: The person's phone number.
Constraints:
Maximum length of 5000
personPoliticalExposure :: Maybe PersonPoliticalExposure'political_exposure: 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.
personRegisteredAddress :: Maybe Addressregistered_address:
personRelationship :: Maybe PersonRelationshiprelationship:
personRequirements :: Maybe (Nullable PersonRequirements'NonNullable)requirements
personSsnLast_4Provided :: Maybe Boolssn_last_4_provided: Whether the last four digits of the person's Social Security number have been provided (U.S. only).
personVerification :: Maybe LegalEntityPersonVerificationverification: