{"_id":"593fe2272418a7003933a374","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"},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","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-17T15:52:13.570Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"As the Marketplace Merchant, you'll send transactions for processing on behalf of your vendors. In this section, we'll cover how to perform transaction requests involving cards, ACH/ECP, subscriptions, and refunds. \n<br />\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Commission Split\",\n  \"body\": \"The commission split will occur when the shopper's funds are captured.\"\n}\n[/block]\nFor transactions involving cards, ACH/ECP, and subscriptions, include the vendor ID in the request body as such: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{ \\n  \\\"vendorInfo\\\": {\\n    \\\"vendorId\\\": \\\"19575974\\\"\\n  }\\n  ...\\n}\",\n      \"language\": \"json\"\n    },\n    {\n      \"code\": \"...\\n<vendor-info>\\n  <vendor-id>19575974</vendor-id> \\n</vendor-info>\\n...\",\n      \"language\": \"xml\",\n      \"name\": \"XML\"\n    }\n  ]\n}\n[/block]\nThe vendor ID will link the transaction to you and your vendor, and will be included as part of the payout calculation. \n\n####Overriding commission rate in a transaction request\nYou have the option to override the commission value (set in the Create and Update Vendor requests) for transactions involving cards, ACH/ECP, and subscriptions. Include the Commission Percent property to override the commission rate with a percentage, or include the Commission Amount property to override the commission rate with a specified amount. \n\n**Commission Percent**\n To override the commission rate with a percent, include the Commission Percent property in the request. In this example, the commission value is 30 percent.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"vendorInfo\\\": {\\n    \\\"vendorId\\\": \\\"19575974\\\", \\n    \\\"commissionPercent\\\": 30\\n  }\\n  ...\\n}\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    },\n    {\n      \"code\": \"...\\n<vendor-info>\\n  <vendor-id>19575974</vendor-id>\\n  <commission-percent>30</commission-percent>\\n</vendor-info>\\n...\",\n      \"language\": \"xml\",\n      \"name\": \"XML\"\n    }\n  ]\n}\n[/block]\n**Commission Amount**\nTo override the commission rate with a specified amount, include the Commission Amount property in the request. In this example, the commission amount is 40. The currency will be the same as the transaction currency. For example, if the transaction currency is USD, the commission amount will be in USD as well. \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"vendorInfo\\\": {\\n    \\\"vendorId\\\": \\\"19575974\\\", \\n    \\\"commissionAmount\\\": 40\\n  }\\n  ...\\n}\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    },\n    {\n      \"code\": \"...\\n<vendor-info>\\n  <vendor-id>19575974</vendor-id>\\n  <commission-amount>40</commission-amount>\\n</vendor-info>\\n...\",\n      \"language\": \"xml\",\n      \"name\": \"XML\"\n    }\n  ]\n}\n[/block]\n###Card transactions\nTo perform an Auth-Capture request on behalf of a vendor, see: \n  * [Auth-Capture - JSON](/v2.1/docs/auth-capture) \n  * [Auth-Capture - XML](/v2.0/docs/auth-capture) \n\nTo perform an Auth-Only request on behalf of a vendor, see: \n  * [Auth-Only - JSON](/v2.1/docs/auth-only) \n  * [Auth-Only - XML](/v2.0/docs/auth-only) \n\n**Note**: To capture the funds later or to reverse the authorization, you'll use the Transaction ID (passed back in the Auth-Only response) within the Capture or Auth Reversal request. \n\n###ACH transactions\nTo perform an ACH/ECP request on behalf of a vendor, see:\n  * [Create ACH/ECP - JSON](/v2.1/docs/create-ecp-transaction) \n  * [Create ACH/ECP - XML](/v2.0/docs/create-ecp-transaction)  \n\n###Subscriptions\nWith BlueSnap's [subscription engine](https://developers.bluesnap.com/v2.1/docs/subscription-management#section-bluesnap-subscription-billing-engine), recurring transactions will run automatically based on the created plan schedule. Each time the transaction is processed, a commission split will be generated and added to your BlueSnap account.\n\nTo create a new subscription on behalf of a vendor, see:\n  * [Create Subscription - JSON](/v2.1/docs/create-subscription) \n  * [Create Subscription - XML](/v2.0/docs/create-subscription)  \n<br />\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Still need to create a plan?\",\n  \"body\": \"To create a plan on behalf of a vendor, see: \\n  * [Create Plan - JSON](/v2.1/docs/create-plan) \\n  * [Create Plan - XML](/v2.0/docs/create-plan)\"\n}\n[/block]\n###Refunds\nWhen you perform a refund on behalf of a vendor, you have the option to manage the refund amount associated with the vendor.  The URL parameter `vendoramount` is used to override the vendor's portion of a refund if so desired.  \n\nExample: `/services/2/transactions/38418858/refund?amount=300&vendoramount=90`\n\nIf `vendoramount` is left blank, the refund will be split according to the commission split set with the original transaction.\n\nVisit our API Reference for more information:\n  * [Refund - JSON](/v2.1/docs/refund) \n  * [Refund - XML](/v2.0/docs/refund)\n\n###Chargebacks\nIn the case of chargebacks, BlueSnap will automatically issue a refund. The refund will be split between the Marketplace Merchant and the associated vendor according to the commission split set with the original transaction. Any chargeback fees will be charged to the Marketplace Merchant. \n<br />\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n##Next: Reporting \nNow that you've learned about how to process transactions, move on to learn about our reporting capabilities. \n\n**[➔ Reporting](/docs/reporting)**","excerpt":"Learn how to send transactions for processing on behalf of your vendors. \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":"processing-transactions","type":"basic","title":"Processing Transactions"}

Processing Transactions

Learn how to send transactions for processing on behalf of your vendors. 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-).

As the Marketplace Merchant, you'll send transactions for processing on behalf of your vendors. In this section, we'll cover how to perform transaction requests involving cards, ACH/ECP, subscriptions, and refunds.

Commission Split

The commission split will occur when the shopper's funds are captured.

For transactions involving cards, ACH/ECP, and subscriptions, include the vendor ID in the request body as such:

{ 
  "vendorInfo": {
    "vendorId": "19575974"
  }
  ...
}
...
<vendor-info>
  <vendor-id>19575974</vendor-id> 
</vendor-info>
...

The vendor ID will link the transaction to you and your vendor, and will be included as part of the payout calculation.

Overriding commission rate in a transaction request

You have the option to override the commission value (set in the Create and Update Vendor requests) for transactions involving cards, ACH/ECP, and subscriptions. Include the Commission Percent property to override the commission rate with a percentage, or include the Commission Amount property to override the commission rate with a specified amount.

Commission Percent
To override the commission rate with a percent, include the Commission Percent property in the request. In this example, the commission value is 30 percent.

{
  "vendorInfo": {
    "vendorId": "19575974", 
    "commissionPercent": 30
  }
  ...
}
...
<vendor-info>
  <vendor-id>19575974</vendor-id>
  <commission-percent>30</commission-percent>
</vendor-info>
...

Commission Amount
To override the commission rate with a specified amount, include the Commission Amount property in the request. In this example, the commission amount is 40. The currency will be the same as the transaction currency. For example, if the transaction currency is USD, the commission amount will be in USD as well.

{
  "vendorInfo": {
    "vendorId": "19575974", 
    "commissionAmount": 40
  }
  ...
}
...
<vendor-info>
  <vendor-id>19575974</vendor-id>
  <commission-amount>40</commission-amount>
</vendor-info>
...

Card transactions

To perform an Auth-Capture request on behalf of a vendor, see:

To perform an Auth-Only request on behalf of a vendor, see:

Note: To capture the funds later or to reverse the authorization, you'll use the Transaction ID (passed back in the Auth-Only response) within the Capture or Auth Reversal request.

ACH transactions

To perform an ACH/ECP request on behalf of a vendor, see:

Subscriptions

With BlueSnap's subscription engine, recurring transactions will run automatically based on the created plan schedule. Each time the transaction is processed, a commission split will be generated and added to your BlueSnap account.

To create a new subscription on behalf of a vendor, see:

Still need to create a plan?

To create a plan on behalf of a vendor, see:

Refunds

When you perform a refund on behalf of a vendor, you have the option to manage the refund amount associated with the vendor. The URL parameter vendoramount is used to override the vendor's portion of a refund if so desired.

Example: /services/2/transactions/38418858/refund?amount=300&vendoramount=90

If vendoramount is left blank, the refund will be split according to the commission split set with the original transaction.

Visit our API Reference for more information:

Chargebacks

In the case of chargebacks, BlueSnap will automatically issue a refund. The refund will be split between the Marketplace Merchant and the associated vendor according to the commission split set with the original transaction. Any chargeback fees will be charged to the Marketplace Merchant.


Back to Top

Next: Reporting

Now that you've learned about how to process transactions, move on to learn about our reporting capabilities.

➔ Reporting