Split Settlement

Split settlements are a financial transaction mechanism designed to distribute funds from a single payment among multiple recipients or entities. This method is commonly employed in various industries, including e-commerce, travel, and marketplaces, where transactions involve multiple stakeholders or partners.

A split settlement begins with a primary transaction, typically a purchase or payment made by a customer. The total amount of this transaction is divided or split among different beneficiaries, each entitled to a specific portion of the total sum.

It’s an efficient, transparent and scalable solution, and are particularly relevant for businesses operating in industries with complex transaction structures involving various stakeholders.

There are two flows available in Split Settlements

Flow 1

When we know the split details before the order is created

This flow will be used when we have all the necessary required information for split details before the order is created at Juspay.

To do a split settlement order along with mandates, pass the below extra parameter of the split settlement in the Session API and in the Mandate Execution call

metadata.split_settlement_details *

String

Mandatory

This will include the split details that need to be passed , which will include total amount to be split as well as the details regarding the split.

Example:- {"marketplace":{"amount":0},"mdr_borne_by":"ALL","vendor":{"split":[{"amount":3,"merchant_commission":0,"sub_mid":"Vendor1"},{"amount":2,"merchant_commission":0,"sub_mid":"Vendor2"}]}}'

Flow 2

When we don’t know the details of split before the order is created

When we do not have the required information of split data in this case, this flow can be used.
In Such cases, no need for sending additional details, post completion of transaction, you can call Fulfilment API to perform split settlement later.

Note

In case of Yes_Biz or Axis_Biz, additional parameter would be required in session API call

metadata.AXIS_BIZ:splitType : “LATER”