Learn how to split transactions with your sub-merchants.
After creating an account holder, you can immediately start processing payments on their behalf.
When a shopper pays on your platform, MarketPay gives you the ability to automatically split these funds between multiple accounts. By splitting payments, you can send the funds belonging to your sub-merchants to their accounts, and your platform fee to your Liable Account.
With every payment, capture, or refund you can customize the split between any number of accounts and amounts including your own Liable Account.
Supported payment methods
MarketPay supports most of the widespread payment methods, such as major card brands (Visa, Mastercard, Amex, Discover/Diners), Apple Pay, Google Pay, SEPA, iDEAL, Sofort, and more.
Providing split information
You can split a payment as many times as you need and into any number of accounts. Payments are split into accounts and not account holders. You can optionally provide split information when capturing or refunding a payment.
Provide split information as an array of split objects in the
splits object. For each split object, you need to specify:
amountto be split.
- The split
typeof MarketPlace sends the amount to the
accountspecified. A split
typeof Commission sends the split to your liable account.
accountto send the split. This is the
accountCodeof one of your account holder's accounts or your own liable account. This is not needed when
reference, this is returned in our reporting for that specific transaction split.
Here is an example for splitting a 400.00 USD transaction:
- 300.00 is being split into an account with
- 100.00 being split into the platform's liable account.
Transactions are split between accounts and not account holders.
Validating split information
Adyen frontend systems only validate the format of the split data. The accounts provided in split data will not be validated by the frontend.
If you provide split data with an account that does not exist, or an account belonging to an inactive account holder, the full amount of the transaction will be sent to the liable account regardless of the original split data.
Processing split payments
To verify how your payment requests work, use test cards provided by Adyen.
For more information, see Test card numbers.
If you do not know what the total split will look like for your account holders at point of a payment, you can skip providing any split data at payment and instead provide split data at capture. Split data provided at capture will override any split data provided with the initial payment request.
Here is an example split provided with
Once a payment has reached the SentForSettle state, the transaction will show up in the account as a PENDING_CREDIT transaction. Once Adyen has received the funds for the payment, the transaction will be updated to CREDITED and the funds will be available to payout on the account.
You can always look at the transaction associated to all accounts on a account holder using
Split at capture
/capture request without split data will use the split data provided at payment authorization.
Some platforms do not know the final split at point of payment. In this case, you can provide split data with a
/capture request. Providing split data at capture overrules the split data provided during the original payment request.
Partial captures require you to supply split data. Not providing split data will cause all the funds to go to the liable account.
Split a refund
/refund request without split data will use the split data provided at payment authorization or capture.
Here is an example refund request without providing split data.
Splitting refund differently than payment or capture
If you want to make a partial refund or split the refund differently than the original split data, you will need to include split data in the refund.
When refunding, you can only use accounts that were part of the original split and you must use the same split
reference you used in the original split.
As an example, lets split a 10 USD payment with 2 USD going to your liable account and 8 USD going to
account 12345. If you provide a split
reference of splitId_1 for the payment, then on the refund, you will need to use the same split
reference of splitId_1.
Here is the example payment of 10 USD with 2 USD going to your liable account and 8 USD to
This following example would be the refund of that payment if you were going to split the refund with 5 USD from your liable account and 5 USD from
Chargeback and disputes
You are responsible for all disputes and dispute management. This includes providing first line support to your shoppers and sub-merchants, clearly communicating your contact details on your website or app, and managing all disputes between your shoppers and your sub-merchants.
Chargebacks, by default, deduct according to original split data. If you want to configure your platform to deduct entirely from your liable account instead, reach out the Support Team.
Partial chargebacks are deducted entirely from your liable account. You can use Fund transfer to correct any account balances.
Manually transfer funds to and from your sub-merchants.
Make scheduled and one-off payouts to sub-merchants.