Mobile SDK

postCreate Vendor

Definition

{{ api_url }}{{ page_api_url }}

Documentation

The Create Vendor request enables you to set up a new vendor who will be associated with your marketplace. The Create Vendor request is where you submit the vendors KYC information, their banking information, the agreed upon commission split and so on.

Important: Vendor verification 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.

In addition, to be eligible for payout, the vendor must meet vendor verification requirements.

Response Examples

Example Descriptions

Create Vendor: Individual

This example shows a Create Vendor request with all the information to fully board an individual vendor. To see the required information for payout, click here.

Create Vendor: Business

This example shows a Create Vendor request with all the information to fully board a business vendor. To see the required information for payout, click here.

Create Vendor: with 2 bank accounts

This example shows a Create Vendor request for an individual vendor with 2 bank accounts. The vendor's bank account details are included within separate payout-info containers (1 bank account per container). In this particular example, the vendor will be paid out in USD (via ACH) and EUR (via SEPA). Their default payout currency is USD.

The following conversion logic will apply:

Since the vendor's payout currencies are USD and EUR, if a sale occurs in either of these currencies, the sales funds will be paid out to the associated bank account.

Since the vendor's default payout currency is USD, if a sale occurs in a currency other than USD or EUR, the sales funds will be converted to USD and paid out to the associated bank account.

API Explorer

To test out a call, enter the request content below and then click Try it!

Tip: Use the XML code below as a starting point. You can enter different parameters to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.