Overview

You can create a vendor and begin processing transactions before collecting their complete onboarding information. However, the vendor will not be paid until their complete details are provided.

To make the vendor eligible for payouts, you must collect all the required information (including KYC details and banking information) and submit it to BlueSnap for verification.

🚧
Be aware that the Create Vendor and Update Vendor API requests used for Marketplace configuration have been updated to support regional payout. The previous payoutInfo object used in these requests has been deprecated and replaced with payoutConfiguration. You must update your requests per their new structure.
If you call the APIs with payoutInfo or if the merchant is not configured for regional payout, an error will be returned.
Additionally, be sure to provide your vendor with a link to the latest BlueSnap Vendor Agreement. They must expressly consent to these terms and conditions before they begin using BlueSnap.

Vendor Statuses

Your vendor will have two statuses to indicate if their account is active/inactive for processing transactions and if they are eligible to receive payout.

Account Status

This status is managed by you, the Marketplace Merchant, and allows you to disable your vendor's ability to sell on your platform. To see an example of updating a vendor's account status, click here.

The possible status values are:

Status Value	Description
Active	By default, your vendor's account is active and they are eligible for transaction processing.
Inactive	Your vendor's account is inactive and they are not eligible for transaction processing. Note: If you change your vendor’s account status to Inactive, your vendor will be paid out for sales they were associated with prior to the status change.

Status Value

Description

Active

By default, your vendor's account is active and they are eligible for transaction processing.

Inactive

Your vendor's account is inactive and they are not eligible for transaction processing.

Note: If you change your vendor’s account status to Inactive, your vendor will be paid out for sales they were associated with prior to the status change.

📘
If you change your vendor's account status from Inactive to Active, their payout status will change to Pending until the account is verified again.

Payout Status

This read-only status, set by BlueSnap, indicates your vendor's eligibility to receive payout based on the vendor information provided.

The possible status values are:

Status Value	Description
Active	BlueSnap has approved your vendor. They are eligible to receive payout.
Inactive	BlueSnap has not approved your vendor. This may be due to insufficient information or another issue with their application. Call the Retrieve Vendor API to get more detailed information and determine what should be done to correct the problem.

Sandbox Testing

While testing in sandbox, the following vendor status logic will apply:

If you do not supply all required vendor payout information, your vendor's payout status will be Inactive.
If you supply all required payout information, your vendor's payout status will change to Active.
A vendor decline can be simulated by sending a Create or Update Vendor request and setting the value of phone to 555-555-5555. Click here to see a code sample.