Create a new beneficial owner for the business

URL Expired

The URL for this request expired after 30 days.

Fields

• customer_id
  Type: string
  Required: Yes
  ID of the Customer (business)

• address_line_one
  Type: string
  Required: Yes
  Address line one.

• address_line_two
  Type: string
  Address line two.

• address_city
  Type: string
  Required: Yes
  Address city.

• address_state
  Type: string
  Required: Yes
  Address state.

• address_zip
  Type: string
  Required: Yes
  Five digit zipcode or nine digit 'ZIP+4'.

• address_country_code
  Type: string
  Enum: ISO 3166-1 alpha-2 country code for the customer.

• name_prefix
  Type: string
  Prefix to the customer's name.

• name_first
  Type: string
  Customer's first name.

• name_middle
  Type: string
  Customer's middle name.

• name_last
  Type: string
  Customer's last name.

• name_suffix
  Type: string
  Suffix to the customer's name.

• passport
  Type: object
  Passport information. required if country is not US

• beneficial_owner_id
  Type: string
  The ID associated to the beneficial owner for future requests. Canopy will generate this field if not provided on creation.

• verification_status
  Type: string | null
  Enum: Status of the verification process (uncertified, certified)

• phone_number
  Type: string
  Customer's phone number in E.164 format.

• email
  Type: string
  The Customer's email address.

• ssn
  Type: string | null
  Full nine digits of their social security number.

• date_of_birth
  Type: string
  Date of Birth in YYYY-MM-DD format

API Responses

• 200 Successful query of information for a specific beneficial owner
• 401 Unauthorized.
• 403 Forbidden.
• 404 Payment Processor not found
• 429 Too many requests.
• default Unexpected Error.

CURL Example

curl --request POST \
     --url https://contact/%20sales%20to%20enable%20your%20sandbox/customers//beneficial_owners \
     --header 'accept: application/json' \
     --header 'content-type: application/json'