Add Merchant Owner

post

https://api.preczn.com/v1/merchants/{merchantId}/owners

Add Owner Details to Merchant Record

Path Params

merchantId

string

required

Body Params

firstName

string

First name.

middleName

string

Middle name.

lastName

string

Last name.

string

Email address.

phone

string

Phone number.

address

object

Address of the contact

businessTitle

string

Business Title.

citizenshipCountry

string

enum

ISO 3166-1 alpha-3 Country Code.

ownershipDate

string

Date when an owner became an owner.

dob

string

Date of birth in YYYY-MM-DD format.

ssn

string

length between 9 and 9

Social security number.

ssnLast4

string

length between 4 and 4

Last 4 digits of social security number.

ownershipPercent

number

Percentage of ownership as a whole integer.

type

string

enum

Owner type

Allowed:

politicallyExposed

boolean

Defaults to false

Publically exposed owner flag.

primaryRepresentative

boolean

Defaults to false

Sponsoring stakeholder from the merchant.

driversLicenseNumber

string

Driver License Number

driversLicenseState

string

Region or State.

driversLicenseExpiration

string

Drivers License Expiration

significantResponsibility

boolean

Defaults to true

Significant Responsibility.

Headers

idempotency-key

string

Unique key to ensure idempotency of requests. If provided, the server will return the same response for subsequent requests with the same key.

Responses

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Owner Created for Merchant.

401Invalid API key.

403Resource Forbidden.

404Merchant not found.

500Unable to service request due to server-side error. Please reattempt request.