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 |
|---|---|---|---|
address | string | optional | Vendor address. Maximum 60 characters. |
city | string | optional | Vendor city. Maximum 40 characters. |
country | string | required | Vendor country; refer to Country codes |
email | string | required | Vendor email. Maximum 150 characters. "+" character is not permitted. |
firstName | string | optional | Vendor first name. Maximum 40 characters. |
ipnUrl | string | optional | This determines where the Payout IPN is sent. Enter the merchant's IPN URL if the Payout IPN should be sent to the merchant. |
lastName | string | optional | Vendor last name. Maximum 40 characters. |
name | string | optional | Vendor / Business name. Maximum 100 characters. |
payoutConfiguration | container | optional | Payout info; refer to payoutConfiguration. |
phone | string | optional | Vendor phone. Maximum 30 characters. |
state | string | optional Applicable if country = US or CA | Vendor state/province; refer to State and Province Codes |
taxId | string | optional; do not include if sending vatId | The company’s business ID number. For example, EIN in the US, Business Number in Canada, Company Number in the UK, etc. Maximum 18 characters. |
termsOfService | container | Required Create Vendor requests only | Information indicating that the vendor has accepted the BlueSnap Vendor Agreement; refer to termsOfService |
vatId | string | optional; do not include if sending taxId | The company’s VAT number. Maximum 18 characters. |
vendorAgreement | container | optional | Vendor commission details; refer to vendorAgreement |
vendorPrincipal | container | optional | Vendor principal; refer to vendorPrincipal |
vendorUrl | string | optional | The main URL for the vendor's business (usually the one accessed by customers). |
zip | string | optional | Vendor zip/postal code. Maximum 20 characters. |
Response
Response contains request properties plus these additions:
| Property Name | Type | Description |
|---|---|---|
vendorId | integer | ID assigned to vendor. To be used on all transactions involving this vendor |
verification | object | Includes information about vendor payout and processing statuses. Refer to verification. |