{"_id":"593fe2272418a7003933a376","category":{"_id":"593fe2262418a7003933a362","version":"593fe2262418a7003933a35e","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-03-17T15:51:04.102Z","from_sync":false,"order":3,"slug":"marketplace","title":"Marketplace"},"project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"user":"560d5913af97231900938124","version":{"_id":"593fe2262418a7003933a35e","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-06-13T13:01:26.536Z","releaseDate":"2017-06-13T13:01:26.536Z","categories":["593fe2262418a7003933a35f","593fe2262418a7003933a360","593fe2262418a7003933a361","593fe2262418a7003933a362","593fe2262418a7003933a363","593fe2262418a7003933a364","593fe2262418a7003933a365"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"3.21.2","version_clean":"8976.0.0-Basics","version":"8976-Basics"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-30T13:17:34.164Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"BlueSnap pays out account funds to you and your vendors. \nConsider the following topics to familiarize yourself with how payout works. \n\n###Marketplace Merchant account vs. Vendor account\nThere are some key differences between your BlueSnap account and your vendors' BlueSnap accounts.\n\n**Marketplace Merchant**\nAs the Marketplace Merchant, you'll have one BlueSnap account, where you'll receive all commission splits on marketplace sales. You will have a bank account (possibly multiple) linked to your BlueSnap account. BlueSnap will pay out your funds to your bank account(s). \n\n**Vendors**\nEach of your vendors will have a BlueSnap account associated with them, where they will receive their commission splits. They will each have a bank account linked to their BlueSnap account, where we will pay out account funds. Your vendor will not have access to BlueSnap. As the Marketplace Merchant, you'll communicate all account information to your vendors. \n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Viewing your vendor's account balance\",\n  \"body\": \"To view your vendor's account balance, use the Vendor Details report - available through both the Merchant Console and [Reporting API](https://developers.bluesnap.com/v4.0/docs/get-report-data).\"\n}\n[/block]\n###Commission\nBlueSnap will pay you and your vendor according to the agreed-upon commission percent. \nThe commission split will occur when the shopper's funds are captured for the sale. \n\nYou can set the commission split between you and your vendor in the following ways:\n\n1. **Create Vendor request** - Include the Commission Percent property in the request to be used for all transactions.  \n\n2. **Update Vendor request** - Include the Commission Percent property in the request to be used for all subsequent transactions. \n\n3. **For a single transaction** - In Auth-Capture, Auth Only, ACH/ECP, and Subscription requests, you may define the commission rate for that specific transaction. Click [here](/docs/processing-transactions#section-overriding-commission-rate-in-a-transaction-request) to learn how. \n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Defining commission rate during vendor creation\",\n  \"body\": \"We recommend that you define your vendor's commission rate (which is part of the [necessary information for payout](/docs/vendor-verification-requirements#section-requirements-for-payout)) during the initial vendor creation. \\n\\nYou can always update the commission rate later via Update Vendor request, or you may override it for a specific transaction.\"\n}\n[/block]\n###Vendor payout schedule\nYour vendor's payout schedule will follow your approved schedule with BlueSnap, meaning that your vendor will inherit both your payout frequency and delay. For example, if you have a frequency of daily, and a delay of 3 days, your vendors will have these same settings. \n\n###Vendor payout methods\nYou can define your vendor's payout method via the Create and Update Vendor requests. We offer the following options for vendor payout: \n* ACH (USD and CAD)\n* SEPA (Euro)\n* CHAPS (UK Pound)\n* WIRE\n\nTo see code samples of the various payout methods, click [here](/docs/vendor-verification-requirements#section-vendor-country-considerations).\n\n###Vendor payout currencies\nYou can define your vendor's payout/base currency via the Create and Update Vendor requests.\nVendors can be paid out in one of the twelve [like-for-like currencies](https://support.bluesnap.com/docs/merchant-faqs#section--can-you-do-like-for-like-does-that-mean-no-fx-mark-up-). \n\n###FX conversion\nTo support multiple currencies in your marketplace, consider the effects that Foreign Exchange (FX) conversion has on item pricing and payout. \n\nSome questions to consider: \n* What happens if the sale occurs in a currency different from the vendor's payout currency?\n* What tools does BlueSnap offer to help with item pricing?\n\nVisit [FX Conversion](doc:fx-conversion) for more information.\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n##Next: API Reference\nNow that you've read through this entire guide, check out our API Reference for all of our API calls and comprehensive examples.\n\n**[➔ API Reference - JSON](/v2.1/docs)**\n**[➔ API Reference - XML](/v2.0/docs)**","excerpt":"Review important topics related to payout and understand how payout works. \nIf you have questions after reading this guide, check out our answers to [frequently asked questions](https://support.bluesnap.com/docs/merchant-faqs#section--what-is-a-marketplace-).","slug":"payout","type":"basic","title":"Payout"}

Payout

Review important topics related to payout and understand how payout works. If you have questions after reading this guide, check out our answers to [frequently asked questions](https://support.bluesnap.com/docs/merchant-faqs#section--what-is-a-marketplace-).

BlueSnap pays out account funds to you and your vendors.
Consider the following topics to familiarize yourself with how payout works.

Marketplace Merchant account vs. Vendor account

There are some key differences between your BlueSnap account and your vendors' BlueSnap accounts.

Marketplace Merchant
As the Marketplace Merchant, you'll have one BlueSnap account, where you'll receive all commission splits on marketplace sales. You will have a bank account (possibly multiple) linked to your BlueSnap account. BlueSnap will pay out your funds to your bank account(s).

Vendors
Each of your vendors will have a BlueSnap account associated with them, where they will receive their commission splits. They will each have a bank account linked to their BlueSnap account, where we will pay out account funds. Your vendor will not have access to BlueSnap. As the Marketplace Merchant, you'll communicate all account information to your vendors.

Viewing your vendor's account balance

To view your vendor's account balance, use the Vendor Details report - available through both the Merchant Console and Reporting API.

Commission

BlueSnap will pay you and your vendor according to the agreed-upon commission percent.
The commission split will occur when the shopper's funds are captured for the sale.

You can set the commission split between you and your vendor in the following ways:

  1. Create Vendor request - Include the Commission Percent property in the request to be used for all transactions.

  2. Update Vendor request - Include the Commission Percent property in the request to be used for all subsequent transactions.

  3. For a single transaction - In Auth-Capture, Auth Only, ACH/ECP, and Subscription requests, you may define the commission rate for that specific transaction. Click here to learn how.

Defining commission rate during vendor creation

We recommend that you define your vendor's commission rate (which is part of the necessary information for payout) during the initial vendor creation.

You can always update the commission rate later via Update Vendor request, or you may override it for a specific transaction.

Vendor payout schedule

Your vendor's payout schedule will follow your approved schedule with BlueSnap, meaning that your vendor will inherit both your payout frequency and delay. For example, if you have a frequency of daily, and a delay of 3 days, your vendors will have these same settings.

Vendor payout methods

You can define your vendor's payout method via the Create and Update Vendor requests. We offer the following options for vendor payout:

  • ACH (USD and CAD)
  • SEPA (Euro)
  • CHAPS (UK Pound)
  • WIRE

To see code samples of the various payout methods, click here.

Vendor payout currencies

You can define your vendor's payout/base currency via the Create and Update Vendor requests.
Vendors can be paid out in one of the twelve like-for-like currencies.

FX conversion

To support multiple currencies in your marketplace, consider the effects that Foreign Exchange (FX) conversion has on item pricing and payout.

Some questions to consider:

  • What happens if the sale occurs in a currency different from the vendor's payout currency?
  • What tools does BlueSnap offer to help with item pricing?

Visit FX Conversion for more information.

Back to Top

Next: API Reference

Now that you've read through this entire guide, check out our API Reference for all of our API calls and comprehensive examples.

➔ API Reference - JSON
➔ API Reference - XML