{"title":"Split payments at authorization","category":"default","creationDate":1676035020,"content":"
\n
Split configuration profiles<\/h5>

Besides splitting payments at the transaction level, you can also set up profiles<\/a> to automatically direct fees and book funds to predefined balance accounts.<\/p><\/div><\/div>\n\n

When accepting in-person payments, you can split the payment amount between the balance accounts in your platform. This allows you to book the sale amount, tip, surcharge, transaction fees, and your platform's commission separately.<\/p>\n

This page describes how to provide split instructions in individual Terminal API payment requests.<\/p>\n

Requirements<\/h2>\n

In addition to the general requirements<\/a> for in-person payments with an Adyen for Platforms integration, take into account the following information.<\/p>\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nA Terminal API<\/a> integration with payment terminals<\/a> or with a Mobile solution<\/a>.
The standalone solution does not support adding split instructions to individual payment authorization requests.<\/div><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n

To provide the split instructions in your payment request, you must:<\/p>\n

    \n
  1. Gather<\/a> the split instructions you need to send in the request.
    \nThe split instructions consist of general information such as the number of splits that the transaction will be divided into, and the details of every split such as the type of split and the account to book the split amount to.<\/li>\n
  2. Format<\/a> the split instructions.
    \nThe split instructions must be provided as a single string value. To achieve that, you can create a JSON object and Base64 encode that, or you can concatenate key-value pairs.<\/li>\n
  3. Make the payment request<\/a>, specifying the string with the split instructions.<\/li>\n
  4. Track the result<\/a>.
    \nThe Terminal API does not validate the balance accounts specified in the split instructions. Using transfer and transaction webhooks, you can check if the funds were booked as intended<\/li>\n<\/ol>\n

    The examples on this page are based on a split payment request for USD 80.00, split three ways:<\/p>\n