View Source Stripe.Person (Striped v0.1.0)

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.

Link to this section Summary

Types

t()

The person type.

Functions

Deletes an existing person’s relationship to the account’s legal entity. Any person with a relationship for an account can be deleted through the API, except if the person is the account_opener. If your integration is using the executive parameter, you cannot delete the only verified executive on file.

Returns a list of people associated with the account’s legal entity. The people are returned sorted by creation date, with the most recent people appearing first.

Retrieves an existing person.

Link to this section Types

@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

Link to this section Functions

Link to this function

create(client, account, params \\ %{})

View Source
@spec create(client :: term(), account :: binary(), params :: map()) ::
  {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Creates a new person.

Details

  • Method: post
  • Path: /v1/accounts/{account}/persons
Link to this function

delete(client, account, person)

View Source
@spec delete(client :: term(), account :: binary(), person :: binary()) ::
  {:ok, Stripe.DeletedPerson.t()}
  | {:error, Stripe.ApiErrors.t()}
  | {:error, term()}

Deletes an existing person’s relationship to the account’s legal entity. Any person with a relationship for an account can be deleted through the API, except if the person is the account_opener. If your integration is using the executive parameter, you cannot delete the only verified executive on file.

Details

  • Method: delete
  • Path: /v1/accounts/{account}/persons/{person}
Link to this function

list(client, account, params \\ %{})

View Source
@spec list(client :: term(), account :: binary(), params :: map()) ::
  {:ok, Stripe.List.t(t())} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Returns a list of people associated with the account’s legal entity. The people are returned sorted by creation date, with the most recent people appearing first.

Details

  • Method: get
  • Path: /v1/accounts/{account}/persons

Query parameters

  • :ending_before string
  • :expand array of: string
  • :limit integer
  • :relationship object with (optional) properties:
    • director: boolean
    • executive: boolean
    • owner: boolean
    • representative: boolean
  • :starting_after string
Link to this function

retrieve(client, account, person, params \\ %{})

View Source
@spec retrieve(
  client :: term(),
  account :: binary(),
  person :: binary(),
  params :: map()
) ::
  {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Retrieves an existing person.

Details

  • Method: get
  • Path: /v1/accounts/{account}/persons/{person}

Query parameters

  • :expand array of: string
Link to this function

update(client, account, person, params \\ %{})

View Source
@spec update(
  client :: term(),
  account :: binary(),
  person :: binary(),
  params :: map()
) ::
  {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Updates an existing person.

Details

  • Method: post
  • Path: /v1/accounts/{account}/persons/{person}