@type additional_document() :: %{
  optional(:back) => binary(),
  optional(:front) => binary()
}

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

@type address() :: %{
  optional(:city) => binary(),
  optional(:country) => binary(),
  optional(:line1) => binary(),
  optional(:line2) => binary(),
  optional(:postal_code) => binary(),
  optional(:state) => binary()
}

The person's address.

@type address_kana() :: %{
  optional(:city) => binary(),
  optional(:country) => binary(),
  optional(:line1) => binary(),
  optional(:line2) => binary(),
  optional(:postal_code) => binary(),
  optional(:state) => binary(),
  optional(:town) => binary()
}

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

@type address_kanji() :: %{
  optional(:city) => binary(),
  optional(:country) => binary(),
  optional(:line1) => binary(),
  optional(:line2) => binary(),
  optional(:postal_code) => binary(),
  optional(:state) => binary(),
  optional(:town) => binary()
}

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

@type company_authorization() :: %{optional(:files) => [binary()]}

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

@type document() :: %{optional(:back) => binary(), optional(:front) => binary()}

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

@type documents() :: %{
  optional(:company_authorization) => company_authorization(),
  optional(:passport) => passport(),
  optional(:visa) => visa()
}

Documents that may be submitted to satisfy various informational requests.

@type passport() :: %{optional(:files) => [binary()]}

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

@type registered_address() :: %{
  optional(:city) => binary(),
  optional(:country) => binary(),
  optional(:line1) => binary(),
  optional(:line2) => binary(),
  optional(:postal_code) => binary(),
  optional(:state) => binary()
}

The person's registered address.

@type t() :: %Stripe.Person{
  account: binary(),
  address: term(),
  address_kana: term() | nil,
  address_kanji: term() | nil,
  created: integer(),
  dob: term(),
  email: binary() | nil,
  first_name: binary() | nil,
  first_name_kana: binary() | nil,
  first_name_kanji: binary() | nil,
  full_name_aliases: term(),
  future_requirements: term() | nil,
  gender: binary() | nil,
  id: binary(),
  id_number_provided: boolean(),
  id_number_secondary_provided: boolean(),
  last_name: binary() | nil,
  last_name_kana: binary() | nil,
  last_name_kanji: binary() | nil,
  maiden_name: binary() | nil,
  metadata: term(),
  nationality: binary() | nil,
  object: binary(),
  phone: binary() | nil,
  political_exposure: binary(),
  registered_address: term(),
  relationship: term(),
  requirements: term() | nil,
  ssn_last_4_provided: boolean(),
  verification: term()
}

The person type.

• account The account the person is associated with.
• address
• address_kana The Kana variation of the person's address (Japan only).
• address_kanji The Kanji variation of the person's address (Japan only).
• created Time at which the object was created. Measured in seconds since the Unix epoch.
• dob
• email The person's email address.
• first_name The person's first name.
• first_name_kana The Kana variation of the person's first name (Japan only).
• first_name_kanji The Kanji variation of the person's first name (Japan only).
• full_name_aliases A list of alternate names or aliases that the person is known by.
• future_requirements Information about the upcoming new requirements for this person, including what information needs to be collected, and by when.
• gender The person's gender (International regulations require either "male" or "female").
• id Unique identifier for the object.
• id_number_provided Whether the person's id_number was provided.
• id_number_secondary_provided Whether the person's id_number_secondary was provided.
• last_name The person's last name.
• last_name_kana The Kana variation of the person's last name (Japan only).
• last_name_kanji The Kanji variation of the person's last name (Japan only).
• maiden_name The person's maiden name.
• metadata 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.
• nationality The country where the person is a national.
• object String representing the object's type. Objects of the same type share the same value.
• phone The person's phone number.
• 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.
• registered_address
• relationship
• requirements Information about the requirements for this person, including what information needs to be collected, and by when.
• ssn_last_4_provided Whether the last four digits of the person's Social Security number have been provided (U.S. only).
• verification

@type verification() :: %{
  optional(:additional_document) => additional_document(),
  optional(:document) => document()
}

The person's verification status.

@type visa() :: %{optional(:files) => [binary()]}

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