{"_id":"5c6c238ff7d5480039535593","category":{"_id":"5c6c238ff7d5480039535560","version":"5c6c238ff7d54800395355a0","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":"5c6c238ff7d54800395355a0","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5beb278ac442ab0213f009cf","createdAt":"2018-04-23T14:36:48.535Z","releaseDate":"2018-04-23T14:36:48.535Z","categories":["5c6c238ff7d548003953555d","5c6c238ff7d548003953555e","5c6c238ff7d548003953555f","5c6c238ff7d5480039535560","5c6c238ff7d5480039535561","5c6c238ff7d5480039535562","5beb278ac442ab0213f00990","5c6c238ff7d5480039535563","5c3f542c12c4ac004bc51718","5c928dba4aa821001ae4f050"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Main","version_clean":"8976.0.0-Basics","version":"8976-Basics"},"githubsync":"","__v":0,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-30T13:17:34.164Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"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, currencies, and methods](#section-vendor-payout-schedule-currencies-and-methods)\n* [Foreign Exchange (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 have one BlueSnap account, where you receive all commission splits on marketplace sales. You have a bank account (possibly multiple) linked to your BlueSnap account. BlueSnap pays out your funds to your bank account(s). \n\n###Vendors\nEach of your vendors has a BlueSnap account associated with them, where they receive their commission splits. They each have a bank account linked to their BlueSnap account, where we pay out account funds. Your vendor does not have access to BlueSnap. As the Marketplace Merchant, you 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/v8976-Tools/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 pays you and your vendor according to the agreed-upon commission percent. \nThe commission split occurs 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)) 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, and methods\n###Vendor payout schedule\nBy default, your vendor's payout schedule follows your approved schedule with BlueSnap, meaning that your vendor inherits 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\nNote 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 or more of the [like-for-like currencies](https://support.bluesnap.com/docs/faqs-currency-conversion#section--can-you-do-like-for-like-does-that-mean-no-fx-foreign-exchange-mark-up-).  To see the full list of payout currencies, [click here](https://support.bluesnap.com/docs/currencies).  \n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"For each of your vendor's payout currencies, there must be an associated bank account. BlueSnap supports only one bank account per payout currency. \\n\\nTo see a code sample of a Create Vendor request for a vendor with 2 payout currencies and 2 bank accounts, click [here](/v8976-JSON/docs/create-vendor#section-examples).\",\n  \"title\": \"Note\"\n}\n[/block]\n###Vendor payout methods\nYou can define your vendor's payout method using the Create and Update Vendor requests. We offer the following options for vendor payout: \n* EFT/ACH using AUD, USD, or CAD\n* SEPA using EUR\n* CHAPS using 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    \\\"minimalPayoutAmount\\\": 25\\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    \\\"minimalPayoutAmount\\\": 25\\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    \\\"minimalPayoutAmount\\\": 25\\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    \\\"minimalPayoutAmount\\\": 25\\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    <minimal-payout-amount>25</minimal-payout-amount>\\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    <minimal-payout-amount>25</minimal-payout-amount>\\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    <minimal-payout-amount>25</minimal-payout-amount>\\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    <minimal-payout-amount>25</minimal-payout-amount>\\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\": \"* We strongly recommend setting your vendor's minimal payout amount to $25 or more to avoid payout delays and negative balances. \\n\\n* 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](/v8976-JSON/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 guide, check out our [**JSON**](/v8976-JSON/docs) or [**XML**](/v8976-XML/docs) API Reference for all of our API calls and comprehensive examples.","excerpt":"Review important topics related to payout and understand how payout works. \nIf you have questions after reading this guide, check out our [FAQs page](https://support.bluesnap.com/docs/faqs-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 [FAQs page](https://support.bluesnap.com/docs/faqs-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 have one BlueSnap account, where you receive all commission splits on marketplace sales. You have a bank account (possibly multiple) linked to your BlueSnap account. BlueSnap pays out your funds to your bank account(s).

Vendors

Each of your vendors has a BlueSnap account associated with them, where they receive their commission splits. They each have a bank account linked to their BlueSnap account, where we pay out account funds. Your vendor does not have access to BlueSnap. As the Marketplace Merchant, you 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 pays you and your vendor according to the agreed-upon commission percent.
The commission split occurs 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, and methods

Vendor payout schedule

By default, your vendor's payout schedule follows your approved schedule with BlueSnap, meaning that your vendor inherits 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.

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 or more of the like-for-like currencies. To see the full list of payout currencies, click here.

Note

For each of your vendor's payout currencies, there must be an associated bank account. BlueSnap supports only one bank account per payout currency.

To see a code sample of a Create Vendor request for a vendor with 2 payout currencies and 2 bank accounts, click here.

Vendor payout methods

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

  • EFT/ACH using AUD, USD, or CAD
  • SEPA using EUR
  • CHAPS using 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", 
    "minimalPayoutAmount": 25
  }]
    ...  
}
{  
  "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", 
    "minimalPayoutAmount": 25
  }]  
  ...   
}
{
  "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", 
    "minimalPayoutAmount": 25
  }]  
  ...  
}
{
  "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", 
    "minimalPayoutAmount": 25
  }]  
  ...  
}
<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>
    <minimal-payout-amount>25</minimal-payout-amount>
  </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>
    <minimal-payout-amount>25</minimal-payout-amount>
  </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>
    <minimal-payout-amount>25</minimal-payout-amount>
  </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>
    <minimal-payout-amount>25</minimal-payout-amount>
  </payout-info>
  
  ...

</vendor>

Reminders:

  • We strongly recommend setting your vendor's minimal payout amount to $25 or more to avoid payout delays and negative balances.

  • 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 guide, check out our JSON or XML API Reference for all of our API calls and comprehensive examples.