{"_id":"59bc55d72b480b0010010cb8","category":{"_id":"59bc55d72b480b0010010c96","version":"59bc55d72b480b0010010c92","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":"59bc55d72b480b0010010c92","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-09-15T22:36:07.078Z","releaseDate":"2017-09-15T22:36:07.078Z","categories":["59bc55d72b480b0010010c93","59bc55d72b480b0010010c94","59bc55d72b480b0010010c95","59bc55d72b480b0010010c96","59bc55d72b480b0010010c97","59bc55d72b480b0010010c98","59bc55d72b480b0010010c99"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"3.22.2 Release","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":26,"body":"BlueSnap pays out account funds to you and your vendors. \nConsider the following topics to familiarize yourself with how payout works. \n* [Marketplace Merchant account vs. vendor account](#section-marketplace-merchant-account-vs-vendor-account)\n* [Commission](#section-commission)\n* [Vendor payout schedule, methods, & currencies](#section-vendor-payout-schedule-currencies-methods)\n* [FX Conversion](#section-fx-conversion)\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<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\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<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Vendor payout schedule, currencies, & methods\n###Vendor payout schedule\nBy default, your vendor's payout schedule will follow your approved schedule with BlueSnap, meaning that your vendor will inherit both your payout frequency and delay unless you modify the `frequency` or `delay` properties in the Create or Update Vendor requests. Depending on your payout schedule, your vendor's payout frequency can be daily, weekly, semimonthly, or monthly.\n\nPlease note that your vendor's payout settings cannot result in quicker payout than your approved schedule with BlueSnap. For example, if you have a payout frequency of daily and a delay of 3 days, then your vendor cannot have a frequency of daily and a delay of 1 day. \n\n###Vendor payout currencies\nYou can define your vendor's payout currencies 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* AUD - Australia Dollar\n* CAD - Canada Dollar\n* CHF - Switzerland Franc\n* DKK - Denmark Kroner\n* EUR - Euro\n* GBP - United Kingdom Pound\n* HKD - Hong Kong Dollar\n* JPY - Japan Yen\n* NOK - Norway Kroner\n* NZD - New Zealand Dollar\n* SEK - Sweden Kroner\n* USD - US Dollar\n\n**Note**: For each of your vendor's payout currencies, they must have an associated bank account. BlueSnap supports one bank account per payout currency. \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 (EUR)\n* CHAPS (GBP)\n* WIRE\n\n####payoutInfo examples\nThe following code samples show how the `payoutInfo` property might vary based on your vendor's payout method.\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-tabs\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"tab\\\" href=\\\"#jsonMenu\\\">JSON</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#xmlMenu\\\">XML</a></li>\\n</ul>\\n\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"jsonMenu\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"payoutInfo\\\": [{\\n    \\\"payoutType\\\": \\\"ACH\\\",\\n    \\\"baseCurrency\\\": \\\"USD\\\",\\n    \\\"nameOnAcccount\\\": \\\"Jane Shopper\\\",\\n    \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n    \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n    \\\"bankName\\\": \\\"First Bank of Newton\\\",\\n    \\\"bankId\\\": \\\"12445\\\",\\n    \\\"country\\\": \\\"US\\\",\\n    \\\"state\\\": \\\"KS\\\",\\n    \\\"city\\\": \\\"Newton\\\",\\n    \\\"address\\\": \\\"128 E Broadway St\\\",\\n    \\\"zip\\\": \\\"67114\\\", \\n    \\\"bankAccountId\\\": \\\"36628822\\\"\\n  }]\\n    ...  \\n}\\n\",\n      \"language\": \"json\",\n      \"name\": \"ACH/ECP\"\n    },\n    {\n      \"code\": \"{  \\n  \\\"payoutInfo\\\": [{\\n    \\\"payoutType\\\": \\\"SEPA\\\",\\n    \\\"baseCurrency\\\": \\\"EUR\\\",\\n    \\\"nameOnAccount\\\": \\\"Jane Shopper\\\",\\n    \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n    \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n    \\\"bankName\\\": \\\"UniCredit\\\",\\n    \\\"bankId\\\": \\\"44352\\\",\\n    \\\"iban\\\": \\\"74466398987773288292902\\\",\\n    \\\"swiftBic\\\": \\\"hhsjeuue\\\",\\n    \\\"country\\\": \\\"AT\\\",\\n    \\\"city\\\": \\\"Leitendorf\\\",\\n    \\\"address\\\": \\\"Anzengrubergasse 14\\\",\\n    \\\"zip\\\": \\\"8700\\\",\\n    \\\"bankAccountId\\\": \\\"377289209\\\"\\n  }]  \\n  ...   \\n}\",\n      \"language\": \"json\",\n      \"name\": \"SEPA\"\n    },\n    {\n      \"code\": \"{\\n  \\\"payoutInfo\\\": [{\\n    \\\"payoutType\\\": \\\"CHAPS\\\",\\n    \\\"baseCurrency\\\": \\\"GBP\\\",\\n    \\\"nameOnAccount\\\": \\\"Jane Shopper\\\",\\n    \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n    \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n    \\\"bankName\\\": \\\"Barclays\\\",\\n    \\\"bankId\\\": \\\"12445\\\",\\n    \\\"iban\\\": \\\"377438437843847300022\\\",\\n    \\\"country\\\": \\\"UK\\\",\\n    \\\"city\\\": \\\"Luton\\\",\\n    \\\"address\\\": \\\"28 George St\\\",\\n    \\\"zip\\\": \\\"LU1 2AE\\\",\\n    \\\"bankAccountId\\\": \\\"36628822\\\"\\n  }]  \\n  ...  \\n}\",\n      \"language\": \"json\",\n      \"name\": \"CHAPS\"\n    },\n    {\n      \"code\": \"{\\n  \\\"payoutInfo\\\": [{\\n    \\\"payoutType\\\": \\\"WIRE\\\",\\n    \\\"baseCurrency\\\": \\\"CAD\\\",\\n    \\\"nameOnAccount\\\": \\\"Jane Shopper\\\",\\n    \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n    \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n    \\\"bankName\\\": \\\"First Bank of Newton\\\",\\n    \\\"bankId\\\": \\\"12445\\\",\\n    \\\"country\\\": \\\"US\\\",\\n    \\\"state\\\": \\\"KS\\\",\\n    \\\"city\\\": \\\"Newton\\\",\\n    \\\"address\\\": \\\"128 E Broadway St\\\",\\n    \\\"zip\\\": \\\"67114\\\",\\n    \\\"bankAccountId\\\": \\\"36628822\\\"\\n  }]  \\n  ...  \\n}\",\n      \"language\": \"json\",\n      \"name\": \"WIRE\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"\\t</div>\\n<div id=\\\"xmlMenu\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n\\n  <payout-info>\\n    <payout-type>ACH</payout-type>\\n    <base-currency>USD</base-currency>\\n    <name-on-account>Jane Shopper</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>PERSONAL</bank-account-class>\\n    <bank-name>First Bank of Newton</bank-name>\\n    <bank-id>12445</bank-id>\\n    <country>US</country>\\n    <state>KS</state>\\n    <city>Newton</city>\\n    <address>128 E Broadway St</address>\\n    <zip>67114</zip>\\n    <bank-account-id>36628822</bank-account-id>\\n  </payout-info>\\n  \\n  ...\\n  \\n</vendor>\",\n      \"language\": \"xml\",\n      \"name\": \"ACH/ECP\"\n    },\n    {\n      \"code\": \"<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n \\n  <payout-info>\\n    <payout-type>SEPA</payout-type>\\n    <base-currency>EUR</base-currency>\\n    <name-on-account>Jane Shopper</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>PERSONAL</bank-account-class>\\n    <bank-name>UniCredit</bank-name>\\n    <bank-id>44352</bank-id>\\n    <iban>74466398987773288292902</iban>\\n    <swift-bic>hhsjeuue</swift-bic>\\n    <country>AT</country>\\n    <city>Leitendorf</city>\\n    <address>Anzengrubergasse 14</address>\\n    <zip>8700</zip>\\n    <bank-account-id>377289209</bank-account-id>\\n  </payout-info>\\n  \\n  ...\\n  \\n</vendor>\",\n      \"language\": \"xml\",\n      \"name\": \"SEPA\"\n    },\n    {\n      \"code\": \"<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n\\n  <payout-info>\\n    <payout-type>CHAPS</payout-type>\\n    <base-currency>GBP</base-currency>\\n    <name-on-account>Jane Shopper</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>PERSONAL</bank-account-class>\\n    <bank-name>Barclays</bank-name>\\n    <bank-id>12445</bank-id>\\n    <iban>377438437843847300022</iban>\\n    <country>UK</country>\\n    <city>Luton</city>\\n    <address>28 George St</address>\\n    <zip>LU1 2AE</zip>\\n    <bank-account-id>36628822</bank-account-id>\\n  </payout-info>\\n  \\n  ...\\n  \\n</vendor>\",\n      \"language\": \"xml\",\n      \"name\": \"CHAPS\"\n    },\n    {\n      \"code\": \"<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n\\n  <payout-info>\\n    <payout-type>WIRE</payout-type>\\n    <base-currency>CAD</base-currency>\\n    <name-on-account>Jane Shopper</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>PERSONAL</bank-account-class>\\n    <bank-name>First Bank of Newton</bank-name>\\n    <bank-id>12445</bank-id>\\n    <country>US</country>\\n    <state>KS</state>\\n    <city>Newton</city>\\n    <address>128 E Broadway St</address>\\n    <zip>67114</zip>\\n    <bank-account-id>36628822</bank-account-id>\\n  </payout-info>\\n  \\n  ...\\n\\n</vendor>\",\n      \"language\": \"xml\",\n      \"name\": \"WIRE\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"</div>\\n</div>\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"* Your vendor's `defaultPayoutCurrency` must have an associated bank account defined within `payoutInfo`. \\n\\n* You may add an additional bank account to your vendor by adding another object inside `payoutInfo` with the bank account details. To see a code sample for a vendor with two bank accounts, click [here](/v2.1/docs/create-vendor#section-examples). \\n\\n* One bank account per payout currency is supported.\",\n  \"title\": \"Reminders:\"\n}\n[/block]\n<hr>\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<hr>\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.

Back to Top


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.

Back to Top


Vendor payout schedule, currencies, & methods

Vendor payout schedule

By default, your vendor's payout schedule will follow your approved schedule with BlueSnap, meaning that your vendor will inherit both your payout frequency and delay unless you modify the frequency or delay properties in the Create or Update Vendor requests. Depending on your payout schedule, your vendor's payout frequency can be daily, weekly, semimonthly, or monthly.

Please note that your vendor's payout settings cannot result in quicker payout than your approved schedule with BlueSnap. For example, if you have a payout frequency of daily and a delay of 3 days, then your vendor cannot have a frequency of daily and a delay of 1 day.

Vendor payout currencies

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

  • AUD - Australia Dollar
  • CAD - Canada Dollar
  • CHF - Switzerland Franc
  • DKK - Denmark Kroner
  • EUR - Euro
  • GBP - United Kingdom Pound
  • HKD - Hong Kong Dollar
  • JPY - Japan Yen
  • NOK - Norway Kroner
  • NZD - New Zealand Dollar
  • SEK - Sweden Kroner
  • USD - US Dollar

Note: For each of your vendor's payout currencies, they must have an associated bank account. BlueSnap supports one bank account per payout currency.

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 (EUR)
  • CHAPS (GBP)
  • WIRE

payoutInfo examples

The following code samples show how the payoutInfo property might vary based on your vendor's payout method.

{
  "payoutInfo": [{
    "payoutType": "ACH",
    "baseCurrency": "USD",
    "nameOnAcccount": "Jane Shopper",
    "bankAccountType": "CHECKING",
    "bankAccountClass": "PERSONAL",
    "bankName": "First Bank of Newton",
    "bankId": "12445",
    "country": "US",
    "state": "KS",
    "city": "Newton",
    "address": "128 E Broadway St",
    "zip": "67114", 
    "bankAccountId": "36628822"
  }]
    ...  
}
{  
  "payoutInfo": [{
    "payoutType": "SEPA",
    "baseCurrency": "EUR",
    "nameOnAccount": "Jane Shopper",
    "bankAccountType": "CHECKING",
    "bankAccountClass": "PERSONAL",
    "bankName": "UniCredit",
    "bankId": "44352",
    "iban": "74466398987773288292902",
    "swiftBic": "hhsjeuue",
    "country": "AT",
    "city": "Leitendorf",
    "address": "Anzengrubergasse 14",
    "zip": "8700",
    "bankAccountId": "377289209"
  }]  
  ...   
}
{
  "payoutInfo": [{
    "payoutType": "CHAPS",
    "baseCurrency": "GBP",
    "nameOnAccount": "Jane Shopper",
    "bankAccountType": "CHECKING",
    "bankAccountClass": "PERSONAL",
    "bankName": "Barclays",
    "bankId": "12445",
    "iban": "377438437843847300022",
    "country": "UK",
    "city": "Luton",
    "address": "28 George St",
    "zip": "LU1 2AE",
    "bankAccountId": "36628822"
  }]  
  ...  
}
{
  "payoutInfo": [{
    "payoutType": "WIRE",
    "baseCurrency": "CAD",
    "nameOnAccount": "Jane Shopper",
    "bankAccountType": "CHECKING",
    "bankAccountClass": "PERSONAL",
    "bankName": "First Bank of Newton",
    "bankId": "12445",
    "country": "US",
    "state": "KS",
    "city": "Newton",
    "address": "128 E Broadway St",
    "zip": "67114",
    "bankAccountId": "36628822"
  }]  
  ...  
}
<vendor xmlns="http://ws.plimus.com">

  <payout-info>
    <payout-type>ACH</payout-type>
    <base-currency>USD</base-currency>
    <name-on-account>Jane Shopper</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>PERSONAL</bank-account-class>
    <bank-name>First Bank of Newton</bank-name>
    <bank-id>12445</bank-id>
    <country>US</country>
    <state>KS</state>
    <city>Newton</city>
    <address>128 E Broadway St</address>
    <zip>67114</zip>
    <bank-account-id>36628822</bank-account-id>
  </payout-info>
  
  ...
  
</vendor>
<vendor xmlns="http://ws.plimus.com">
 
  <payout-info>
    <payout-type>SEPA</payout-type>
    <base-currency>EUR</base-currency>
    <name-on-account>Jane Shopper</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>PERSONAL</bank-account-class>
    <bank-name>UniCredit</bank-name>
    <bank-id>44352</bank-id>
    <iban>74466398987773288292902</iban>
    <swift-bic>hhsjeuue</swift-bic>
    <country>AT</country>
    <city>Leitendorf</city>
    <address>Anzengrubergasse 14</address>
    <zip>8700</zip>
    <bank-account-id>377289209</bank-account-id>
  </payout-info>
  
  ...
  
</vendor>
<vendor xmlns="http://ws.plimus.com">

  <payout-info>
    <payout-type>CHAPS</payout-type>
    <base-currency>GBP</base-currency>
    <name-on-account>Jane Shopper</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>PERSONAL</bank-account-class>
    <bank-name>Barclays</bank-name>
    <bank-id>12445</bank-id>
    <iban>377438437843847300022</iban>
    <country>UK</country>
    <city>Luton</city>
    <address>28 George St</address>
    <zip>LU1 2AE</zip>
    <bank-account-id>36628822</bank-account-id>
  </payout-info>
  
  ...
  
</vendor>
<vendor xmlns="http://ws.plimus.com">

  <payout-info>
    <payout-type>WIRE</payout-type>
    <base-currency>CAD</base-currency>
    <name-on-account>Jane Shopper</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>PERSONAL</bank-account-class>
    <bank-name>First Bank of Newton</bank-name>
    <bank-id>12445</bank-id>
    <country>US</country>
    <state>KS</state>
    <city>Newton</city>
    <address>128 E Broadway St</address>
    <zip>67114</zip>
    <bank-account-id>36628822</bank-account-id>
  </payout-info>
  
  ...

</vendor>

Reminders:

  • Your vendor's defaultPayoutCurrency must have an associated bank account defined within payoutInfo.

  • You may add an additional bank account to your vendor by adding another object inside payoutInfo with the bank account details. To see a code sample for a vendor with two bank accounts, click here.

  • One bank account per payout currency is supported.


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