Split Settlement
Overview
Split Settlement is a feature that allows you to split the amount of the transaction into more than one settlement bank account. It's an ideal solution for merchants requiring customized settlement rules that can be used for marketplaces, platforms, franchises, as well as businesses with multiple branches.
Split Settlement can be configured based on a percentage or a fixed amount. Split Settlement can be set up either via API or DOKU Dashboard for every successful transaction that occurred on the same day.
Activation
You can activate split settlement by following the steps below:
Log in to DOKU Dashboard, and then access the side navigation bar
Select Settings from the menu
Settings page will appear. Under Account section, select Service
On Service page, click ADD SERVICE button
A pop-up window will appear with service options. Scroll down to find "Financial Services." Check the Split Settlement checkbox and click "Activate" as shown below
Ensure that the Split Settlement service appears on the Services page
Split Settlement service will have the status "UPDATING" when it is first added, and once it has been verified by DOKU, the status will change to "ACTIVE".
Configuration
You can configure split settlement or update existing configuration to transactions using DOKU Dashboard by following the steps below:
Log in to DOKU Dashboard, and then access the side navigation bar
Select Reports from the menu, then choose Reconciled Transactions
Filter transactions with the status "Payment Success", then click search
Once the relevant transactions appear, locate the action table on the right side
Click the "⁝" icon in the action column
A pop-up will appear; select "Settlement Configuration"
Details of the transaction and the destination bank account will be shown
Click "Split Transaction" in the pop-up box
To add more bank accounts, leave the value field empty and click "Add more bank"
Adjust the bank account destination and split amount as needed.
Select the amount type (fixed amount or percentage) by clicking "Split by"
Add more bank accounts if needed. A maximum of 10 destination bank accounts are allowed
Ensure the following rules are adhered when values are being input for split settlement
If "Split by Percent" is selected, the total percentage input must not exceed 100%
If "Split by Fixed Amount" is selected, the total input amount must not exceed the "Total Settlement Amount" specified
Click "Save Configuration" to convert the transaction to split settlement. There will be an indicator that your transaction has been marked for split settlement under "Invoice Number" column.
Cancellation
Transactions that have been previously configured to be split settled can still be cancelled as long as the transaction status remains as "Payment Success". You can cancel the split settlement of a transaction by following the steps below:
Log in to DOKU Dashboard, and then access the side navigation bar
Select Reports from the menu, then choose Reconciled Transactions
Filter transactions with "Payment Success" status and "Split Settlement" set to "Yes," then click "Search"
Select a transaction, proceed to the action menu and click "Settlement Configuration."
Details of the transaction and the destination bank account will be shown
There are two ways to cancel split settlement of a transaction:
Click the ⛔ icon next to the bank account until only one account remains, then click "Save Configuration"
Alternatively, click "Reset Configuration," then "Save Configuration"
Upon successful cancellation, a success notification will appear, and the split settlement icon will vanish.
Troubleshooting
Invalid Split Settlement Bank Account
An invalid split settlement bank account error occurred due to an incorrect input of the split settlement bank account destination configuration. This caused our system to be unable to process the settlement with the transaction status "Pending Settlement".
Log in to DOKU Dashboard, and then access the side navigation bar
Select Reports from the menu, then choose Reconciled Transactions
Filter transactions with "Pending Settlement" status and input the invoice number, then search
Changes can be made if the transaction remark is "Split Settlement Bank Account Invalid." Click "Settlement Configuration" to modify data
A pop-up box will appear that shows the settlement configuration of the transaction, then fill the necessary fields field
After the pop up settlement configuration page appears, fill in the empty bank account field with a valid bank account.
After selecting the desired bank account, click “Save Configuration”
Upon a success configuration, a notification will appear.
Notable Rule
Through split settlement, merchants receive data distribution from several settlement batches based on configured accounts.
If the configured split settlement amount is less than the total settlement amount, the remainder goes to the default account set on the Settlement Settings page.
Configuration changes can only be made for transactions with "Payment Success" and "Pending Settlement" statuses. Transactions with other statuses cannot be changed as the settlement batches have been created.
Refunding a split settlement transaction deducts the split amounts from upcoming batches. Refund fees from DOKU are subtracted from the batch settlement funds. The following is an illustration of how refunding a split settlement transaction is processed.
A transaction contains an amount of IDR 100,000 with a fee of IDR 5,000
60% is settled to bank account X
40% is settled to bank account Y
If a refund occurs, the amount transferred to bank account X is reduced by IDR 60,000 and bank account Y is reduced by IDR 40,000.
Refund fees are deducted from batch settlements recorded on Settlement Settings page.
Status Mapping
Payment Success: Successfully recorded transactions in the DOKU system, to be distributed to merchants per configured settings.
Pending Settlement: Successful transactions reconciled between DOKU & Acquirer but pending due to incorrect transaction information or configuration.
Total Settlement Amount: Net transaction value DOKU will distribute to the merchant.
FAQ
Last updated