{"_id":"593fe2272418a7003933a372","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:18:01.949Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"###Requirements for processing transactions\nThe minimum requirements for a vendor to begin selling are country and email, as shown in the following Create Vendor example. \n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{ \\n    \\\"email\\\": \\\"jane.shopper:::at:::bluesnap.com\\\", \\n    \\\"country\\\": \\\"US\\\"\\n     ... \\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"JSON\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n    <email>jane.shopper@bluesnap.com</email>\\n    <country>US</country>\\n    ...\\n</vendor>'\",\n      \"language\": \"curl\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\n\n###Requirements for payout\nIn this section, we will outline the necessary information for payout.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Vendor information will vary\",\n  \"body\": \"➔ Vendor accounts for individuals will require information about the person, and vendor accounts for businesses will require information about the business and a business representative.\\n\\n➔ Some information will vary based on the vendor's country, such as Payout Information and Personal Identification Number. Scroll down to  [Vendor Country Considerations](#section-vendor-country-considerations) for more details.\"\n}\n[/block]\nThe following Create Vendor code samples outline the required properties for payout for both individual and business vendors. In these code samples, we have a US vendor with a payout method of ACH/ECP. Scroll down to [Vendor Country Considerations](#section-vendor-country-considerations) for more on vendor payout methods.\n\n*Use these code samples as a template, and modify specific properties based on your vendor.*\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-tabs\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"tab\\\" href=\\\"#json\\\">JSON</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#xml\\\">XML</a></li>\\n</ul>\\n\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"json\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n    \\\"email\\\": \\\"marketplaceMerchantEmail@example.com\\\",\\n    \\\"firstName\\\": \\\"Joe\\\",\\n    \\\"lastName\\\": \\\"Smith\\\",\\n    \\\"phone\\\": \\\"1-123-456-7890\\\",\\n    \\\"address\\\": \\\"123 Main Street\\\",\\n    \\\"city\\\": \\\"Boston\\\",\\n    \\\"country\\\": \\\"US\\\",\\n    \\\"state\\\":\\\"MA\\\",\\n    \\\"zip\\\": \\\"123456\\\",\\n    \\\"vendorPrincipal\\\": {\\n        \\\"firstName\\\": \\\"Joe\\\",\\n        \\\"lastName\\\": \\\"Smith\\\",\\n        \\\"address\\\": \\\"123 Main Street\\\",\\n        \\\"city\\\": \\\"Boston\\\",\\n        \\\"country\\\": \\\"US\\\",\\n        \\\"zip\\\": \\\"123456\\\",\\n        \\\"dob\\\": \\\"28-09-9999\\\",\\n        \\\"personalIdentificationNumber\\\": \\\"1234\\\",\\n      \\t\\\"passportNumber\\\": \\\"7676234872\\\",\\n        \\\"email\\\": \\\"individual.vendor@bluesnap.com\\\"\\n    },\\n    \\\"vendorAgreement\\\": {\\n        \\\"commissionPercent\\\": \\\"30\\\"\\n    },\\n    \\\"payoutInfo\\\": [{\\n        \\\"payoutType\\\": \\\"ACH\\\",\\n        \\\"baseCurrency\\\": \\\"USD\\\",\\n        \\\"nameOnAccount\\\": \\\"vendor\\\",\\n        \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n        \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n        \\\"bankName\\\": \\\"Leumi\\\",\\n        \\\"bankId\\\": \\\"12445\\\",\\n        \\\"country\\\": \\\"US\\\",\\n        \\\"state\\\":\\\"MA\\\",\\n        \\\"city\\\": \\\"Juneau\\\",\\n        \\\"address\\\": \\\"1 bank address\\\",\\n        \\\"zip\\\": \\\"12345\\\",\\n        \\\"bankAccountId\\\": \\\"36628822\\\"\\n    }]\\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"Individual\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n    \\\"name\\\": \\\"Business ABC\\\", \\n    \\\"email\\\": \\\"marketplaceMerchantEmail@example.com\\\", \\n    \\\"phone\\\": \\\"1-123-455-8765\\\", \\n    \\\"address\\\": \\\"25 Business Avenue\\\", \\n    \\\"city\\\": \\\"Boston\\\", \\n    \\\"country\\\": \\\"US\\\", \\n    \\\"state\\\": \\\"MA\\\", \\n    \\\"zip\\\": \\\"123456\\\", \\n    \\\"taxId\\\": 123456789, \\n    \\\"vendorPrincipal\\\": {\\n        \\\"firstName\\\": \\\"Joe\\\",\\n        \\\"lastName\\\": \\\"Smith\\\",\\n        \\\"address\\\": \\\"123 Main Street\\\",\\n        \\\"city\\\": \\\"Boston\\\",\\n        \\\"country\\\": \\\"US\\\",\\n        \\\"zip\\\": \\\"12345\\\",\\n        \\\"dob\\\": \\\"28-09-9999\\\",\\n        \\\"personalIdentificationNumber\\\": \\\"1234\\\",\\n      \\t\\\"passportNumber\\\": \\\"7676234872\\\",\\n        \\\"email\\\": \\\"principal.vendor@email.com\\\"\\n    }, \\n    \\\"vendorAgreement\\\": {\\n        \\\"commissionPercent\\\": \\\"30\\\"\\n      },\\n    \\\"payoutInfo\\\": [{\\n        \\\"payoutType\\\": \\\"ACH\\\",\\n        \\\"baseCurrency\\\": \\\"USD\\\",\\n        \\\"nameOnAccount\\\": \\\"name of vendor account\\\",\\n        \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n        \\\"bankAccountClass\\\": \\\"CORPORATE\\\",\\n        \\\"bankName\\\": \\\"Bank of America\\\",\\n        \\\"bankId\\\": \\\"12445\\\",\\n        \\\"country\\\": \\\"US\\\",\\n        \\\"state\\\":\\\"MA\\\",\\n        \\\"city\\\": \\\"Boston\\\",\\n        \\\"address\\\": \\\"1 bank address\\\",\\n        \\\"zip\\\": \\\"12345\\\",\\n        \\\"bankAccountId\\\": \\\"36628822\\\"\\n      }]\\n}'\",\n      \"language\": \"curl\",\n      \"name\": \"Business \"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"\\t</div>\\n<div id=\\\"xml\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n  <email>marketplaceMerchantEmail@example.com</email>\\n  <first-name>Joe</first-name>\\n  <last-name>Smith</last-name>\\n  <phone>1-123-456-7890</phone>\\n  <address>123 Main Street</address>\\n  <city>Boston</city>\\n  <country>US</country>\\n  <state>MA</state>\\n  <zip>123456</zip>\\n  <vendor-principal>\\n    <first-name>Joe</first-name>\\n    <last-name>Smith</last-name>\\n    <address>123 Main Street</address>\\n    <city>Boston</city>\\n    <country>US</country>\\n    <zip>123456</zip>\\n    <dob>28-09-9999</dob>\\n    <personal-identification-number>1234</personal-identification-number>\\n    <passport-number>7676234872</passport-number>\\n    <email>individual.vendor@bluesnap.com</email>\\n  </vendor-principal>\\n  <vendor-agreement>\\n    <commission-percent>30</commission-percent>\\n  </vendor-agreement>\\n  <payout-info>\\n    <payout-type>ACH</payout-type>\\n    <base-currency>USD</base-currency>\\n    <name-on-account>vendor</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>PERSONAL</bank-account-class>\\n    <bank-name>Leumi</bank-name>\\n    <bank-id>12445</bank-id>\\n    <country>US</country>\\n    <state>MA</state>\\n    <city>Juneau</city>\\n    <address>1 bank address</address>\\n    <zip>12345</zip>\\n    <bank-account-id>36628822</bank-account-id>\\n  </payout-info>\\n</vendor>'\",\n      \"language\": \"curl\",\n      \"name\": \"Individual \"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<vendor xmlns=\\\"http://ws.plimus.com\\\">\\n  <name>Business ABC</name>\\n  <email>marketplaceMerchantEmail@example.com</email>\\n  <phone>1-123-455-8765</phone>\\n  <address>25 Business Avenue</address>\\n  <city>Boston</city>\\n  <country>US</country>\\n  <state>MA</state>\\n  <zip>123456</zip>\\n  <tax-id>123456789</tax-id>\\n  <vendor-principal>\\n    <first-name>Joe</first-name>\\n    <last-name>Smith</last-name>\\n    <address>123 Main Street</address>\\n    <city>Boston</city>\\n    <country>US</country>\\n    <zip>12345</zip>\\n    <dob>28-09-9999</dob>\\n    <personal-identification-number>1234</personal-identification-number>\\n    <passport-number>7676234872</passport-number>\\n    <email>principal.vendor@email.com</email>\\n  </vendor-principal>\\n  <vendor-agreement>\\n    <commission-percent>30</commission-percent>\\n  </vendor-agreement>\\n  <payout-info>\\n    <payout-type>ACH</payout-type>\\n    <base-currency>USD</base-currency>\\n    <name-on-account>name of vendor account</name-on-account>\\n    <bank-account-type>CHECKING</bank-account-type>\\n    <bank-account-class>CORPORATE</bank-account-class>\\n    <bank-name>Bank of America</bank-name>\\n    <bank-id>12445</bank-id>\\n    <country>US</country>\\n    <state>MA</state>\\n    <city>Boston</city>\\n    <address>1 bank address</address>\\n    <zip>12345</zip>\\n    <bank-account-id>36628822</bank-account-id>\\n  </payout-info>\\n</vendor>'\",\n      \"language\": \"curl\",\n      \"name\": \"Business \"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"\\t</div>\\n</div>\"\n}\n[/block]\n <a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n####Vendor country considerations\n* **Tax ID and VAT ID**\n  * Businesses will require a Tax ID or VAT ID, depending on the business' country. For example, the Tax ID will be an EIN for a business in the US, Business Number in CA, Company Number in the UK, etc.\n\n* **Personal Identification Number**\n  * Personal Identification Number is required for both individuals and businesses, and the value will vary based on the vendor's country. For example, in the US, this value will be the last four digits of the SSN, and for countries outside the US, this value will be the full National Identification Number.\n\n* **Passport Number or Driver License Number**\n * Either a passport number or a driver license number is required for your vendor. \n\n* **Payout Information**\n  * Your vendor's payout information will vary based on their payout method and currency (see [payout](/docs/payout#section-vendor-payout-methods) for more on the payout methods and currencies available).  \n\nThe following Create Vendor code samples show how the Payout Info property might vary based on the 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\": \"\\t</div>\\n</div>\"\n}\n[/block]\n####For more information: \nVisit our API Reference for more information on any of the vendor account properties: \n\n  * [Vendor Object - JSON](/v2.1/docs/vendorinfo) \n  * [Vendor Resource - XML](/v2.0/docs/vendor) \n<br />\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Missing vendor information\",\n  \"body\": \"BlueSnap will ask for additional information if it is needed for vendor verification (i.e. driver's license or passport image).\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Staying informed of your vendor's account status\",\n  \"body\": \"Any changes to your vendor’s account status will be sent to you via the `VENDOR_STATUS_CHANGED` [webhook](/docs/vendor-onboarding#section-staying-informed-with-webhooks). \\n\\nIf your vendor's account status has switched to `approved`, then your vendor is eligible for payout.\"\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n##Next: Updating Vendor Accounts\nNow that you've learned about the vendor verification requirements for processing transactions and payout eligibility, move on to updating your vendor's account. \n\n**[➔ Updating Vendor Accounts](/docs/updating-vendor-accounts)**","excerpt":"Learn about the vendor verification requirements for processing transactions and payout eligibility.\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":"vendor-verification-requirements","type":"basic","title":"Vendor Verification Requirements"}

Vendor Verification Requirements

Learn about the vendor verification requirements for processing transactions and payout eligibility. 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-).

Requirements for processing transactions

The minimum requirements for a vendor to begin selling are country and email, as shown in the following Create Vendor example.

curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{ 
    "email": "jane.shopper@bluesnap.com", 
    "country": "US"
     ... 
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<vendor xmlns="http://ws.plimus.com">
    <email>jane.shopper@bluesnap.com</email>
    <country>US</country>
    ...
</vendor>'

Requirements for payout

In this section, we will outline the necessary information for payout.

Vendor information will vary

➔ Vendor accounts for individuals will require information about the person, and vendor accounts for businesses will require information about the business and a business representative.

➔ Some information will vary based on the vendor's country, such as Payout Information and Personal Identification Number. Scroll down to Vendor Country Considerations for more details.

The following Create Vendor code samples outline the required properties for payout for both individual and business vendors. In these code samples, we have a US vendor with a payout method of ACH/ECP. Scroll down to Vendor Country Considerations for more on vendor payout methods.

Use these code samples as a template, and modify specific properties based on your vendor.

curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "email": "marketplaceMerchantEmail@example.com",
    "firstName": "Joe",
    "lastName": "Smith",
    "phone": "1-123-456-7890",
    "address": "123 Main Street",
    "city": "Boston",
    "country": "US",
    "state":"MA",
    "zip": "123456",
    "vendorPrincipal": {
        "firstName": "Joe",
        "lastName": "Smith",
        "address": "123 Main Street",
        "city": "Boston",
        "country": "US",
        "zip": "123456",
        "dob": "28-09-9999",
        "personalIdentificationNumber": "1234",
      	"passportNumber": "7676234872",
        "email": "individual.vendor@bluesnap.com"
    },
    "vendorAgreement": {
        "commissionPercent": "30"
    },
    "payoutInfo": [{
        "payoutType": "ACH",
        "baseCurrency": "USD",
        "nameOnAccount": "vendor",
        "bankAccountType": "CHECKING",
        "bankAccountClass": "PERSONAL",
        "bankName": "Leumi",
        "bankId": "12445",
        "country": "US",
        "state":"MA",
        "city": "Juneau",
        "address": "1 bank address",
        "zip": "12345",
        "bankAccountId": "36628822"
    }]
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
    "name": "Business ABC", 
    "email": "marketplaceMerchantEmail@example.com", 
    "phone": "1-123-455-8765", 
    "address": "25 Business Avenue", 
    "city": "Boston", 
    "country": "US", 
    "state": "MA", 
    "zip": "123456", 
    "taxId": 123456789, 
    "vendorPrincipal": {
        "firstName": "Joe",
        "lastName": "Smith",
        "address": "123 Main Street",
        "city": "Boston",
        "country": "US",
        "zip": "12345",
        "dob": "28-09-9999",
        "personalIdentificationNumber": "1234",
      	"passportNumber": "7676234872",
        "email": "principal.vendor@email.com"
    }, 
    "vendorAgreement": {
        "commissionPercent": "30"
      },
    "payoutInfo": [{
        "payoutType": "ACH",
        "baseCurrency": "USD",
        "nameOnAccount": "name of vendor account",
        "bankAccountType": "CHECKING",
        "bankAccountClass": "CORPORATE",
        "bankName": "Bank of America",
        "bankId": "12445",
        "country": "US",
        "state":"MA",
        "city": "Boston",
        "address": "1 bank address",
        "zip": "12345",
        "bankAccountId": "36628822"
      }]
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<vendor xmlns="http://ws.plimus.com">
  <email>marketplaceMerchantEmail@example.com</email>
  <first-name>Joe</first-name>
  <last-name>Smith</last-name>
  <phone>1-123-456-7890</phone>
  <address>123 Main Street</address>
  <city>Boston</city>
  <country>US</country>
  <state>MA</state>
  <zip>123456</zip>
  <vendor-principal>
    <first-name>Joe</first-name>
    <last-name>Smith</last-name>
    <address>123 Main Street</address>
    <city>Boston</city>
    <country>US</country>
    <zip>123456</zip>
    <dob>28-09-9999</dob>
    <personal-identification-number>1234</personal-identification-number>
    <passport-number>7676234872</passport-number>
    <email>individual.vendor@bluesnap.com</email>
  </vendor-principal>
  <vendor-agreement>
    <commission-percent>30</commission-percent>
  </vendor-agreement>
  <payout-info>
    <payout-type>ACH</payout-type>
    <base-currency>USD</base-currency>
    <name-on-account>vendor</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>PERSONAL</bank-account-class>
    <bank-name>Leumi</bank-name>
    <bank-id>12445</bank-id>
    <country>US</country>
    <state>MA</state>
    <city>Juneau</city>
    <address>1 bank address</address>
    <zip>12345</zip>
    <bank-account-id>36628822</bank-account-id>
  </payout-info>
</vendor>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/vendors \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<vendor xmlns="http://ws.plimus.com">
  <name>Business ABC</name>
  <email>marketplaceMerchantEmail@example.com</email>
  <phone>1-123-455-8765</phone>
  <address>25 Business Avenue</address>
  <city>Boston</city>
  <country>US</country>
  <state>MA</state>
  <zip>123456</zip>
  <tax-id>123456789</tax-id>
  <vendor-principal>
    <first-name>Joe</first-name>
    <last-name>Smith</last-name>
    <address>123 Main Street</address>
    <city>Boston</city>
    <country>US</country>
    <zip>12345</zip>
    <dob>28-09-9999</dob>
    <personal-identification-number>1234</personal-identification-number>
    <passport-number>7676234872</passport-number>
    <email>principal.vendor@email.com</email>
  </vendor-principal>
  <vendor-agreement>
    <commission-percent>30</commission-percent>
  </vendor-agreement>
  <payout-info>
    <payout-type>ACH</payout-type>
    <base-currency>USD</base-currency>
    <name-on-account>name of vendor account</name-on-account>
    <bank-account-type>CHECKING</bank-account-type>
    <bank-account-class>CORPORATE</bank-account-class>
    <bank-name>Bank of America</bank-name>
    <bank-id>12445</bank-id>
    <country>US</country>
    <state>MA</state>
    <city>Boston</city>
    <address>1 bank address</address>
    <zip>12345</zip>
    <bank-account-id>36628822</bank-account-id>
  </payout-info>
</vendor>'

Back to Top

Vendor country considerations

  • Tax ID and VAT ID

    • Businesses will require a Tax ID or VAT ID, depending on the business' country. For example, the Tax ID will be an EIN for a business in the US, Business Number in CA, Company Number in the UK, etc.
  • Personal Identification Number

    • Personal Identification Number is required for both individuals and businesses, and the value will vary based on the vendor's country. For example, in the US, this value will be the last four digits of the SSN, and for countries outside the US, this value will be the full National Identification Number.
  • Passport Number or Driver License Number

    • Either a passport number or a driver license number is required for your vendor.
  • Payout Information

    • Your vendor's payout information will vary based on their payout method and currency (see payout for more on the payout methods and currencies available).

The following Create Vendor code samples show how the Payout Info property might vary based on the 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>

For more information:

Visit our API Reference for more information on any of the vendor account properties:

Missing vendor information

BlueSnap will ask for additional information if it is needed for vendor verification (i.e. driver's license or passport image).

Staying informed of your vendor's account status

Any changes to your vendor’s account status will be sent to you via the VENDOR_STATUS_CHANGED webhook.

If your vendor's account status has switched to approved, then your vendor is eligible for payout.

Back to Top

Next: Updating Vendor Accounts

Now that you've learned about the vendor verification requirements for processing transactions and payout eligibility, move on to updating your vendor's account.

➔ Updating Vendor Accounts