vendorPrincipal

Request

📘

Vendor requirements

Initially, you do not need all your vendor's information to submit the request to immediately begin processing transactions; however, to fully board your vendor, you must collect all the necessary Know Your Customer (KYC), banking, and any additional required information from them, and submit to BlueSnap for verification.

Property Name

Type

Required

Description

firstName

string

Required

First name of vendor principal owner. Maximum 40 characters.

lastName

string

Required

Last name of vendor principal owner. Maximum 40 characters.

address

string

Required

Address of vendor principal owner. Maximum 60 characters.

address2

string

Optional

Address line 2 of vendor principal owner. Maximum 60 characters.

city

string

Required

City of vendor principal owner. Maximum 40 characters.

country

string

Required

Country code of vendor principal owner. See Country Codes.

zip

string

Required

Zip of vendor principal owner. Maximum 10 characters.

dob

string

Required

Date of Birth of vendor principal owner

Format: dd-mm-yyyy

personalIdentificationNumber

string

Required if vendor principal country is US

In the US, this value is the last four digits of the principal owner's Social Security Number.

In countries outside of the US, this value is the full National Identification Number of the principal owner, or TaxID if the country doesn’t support a National Identification Number.

Maximum 25 characters.

Note: If the vendor principal country is not the US, only one of personalIdentificationNumber, driverLicenseNumber or passportNumber is required.

driverLicenseNumber

string

Optional

Driver license number of vendor principal owner. Maximum 20 alphanumeric characters.

Note: If the vendor principal country is not the US, only one of personalIdentificationNumber, driverLicenseNumber or passportNumber is required.

passportNumber

string

Optional

Passport number of vendor principal owner. Maximum 20 alphanumeric characters.

Note: If the vendor principal country is not the US, only one of personalIdentificationNumber, driverLicenseNumber or passportNumber is required.

email

string

Required

Email address of vendor principal owner. Maximum 150 characters. "+" character is not permitted.