---
updatedAt: 2026-07-27T09:12:27.000Z
agentTools:
  projectIndex: https://docs.dlocal.com/llms.txt
---

# Split payments

Learn how to accept and split payment into your platform.

[block:html]
{
  "html": "<style>\n  \n  .main {\n    margin-left: auto;\n    margin-right: auto;\n    margin-bottom: 5px;\n    display: grid;\n    grid-template-columns: repeat(3, 1fr); /* Tres columnas */\n    width: 740px; /* Ancho máximo de la caja */\n}\n\n.overview-card1 {\n    position: relative; /* Asegúrate de que el contenedor sea relativo para posicionar el pseudoelemento */\n    width: 100%;\n    box-sizing: border-box;\n    margin: 0;\n}\n\n.overview-card1::after {\n    content: '';\n    position: absolute;\n    right: 0; /* Pega la línea al borde derecho */\n    top: 30%; /* Ajusta la posición superior de la línea */\n    height: 70%; /* Establece el alto de la línea al 60% */\n    width: 1px; /* Grosor de la línea */\n    background-color: #D2D8EC; /* Color de la línea */\n}\n\n  .overview-card2 {\n    position: relative; /* Asegúrate de que el contenedor sea relativo para posicionar el pseudoelemento */\n    width: 100%;\n    box-sizing: border-box;\n    margin: 0;\n}\n\n  \n.overview-card-upper-side1 {\n    height: 105px;\n    padding: 20px;\n    background-color: transparent;\n    text-align: left;\n}\n\n.overview-card-bottom-side {\n    position: relative;\n    width: 100%;\n    height: 100%;\n    padding: 30px;\n    padding-right: 20px;\n    background-color: transparent;\n    border-radius: 16px;\n}\n\n.overview-card-title1 {\n    font-family: 'Plus Jakarta Sans', sans-serif;\n    font-size: 24px;\n    font-weight: 700;\n    line-height: 26.4px;\n}\n\n.overview-card-content1 {\n    font-size: 14px;\n    font-weight: 300;\n    margin-top: 20px;\n    line-height: 20px;\n    margin-bottom: 40px!important;\n}\n\n.overview-icon1 {\n    margin-bottom: -5px;\n    margin-top: 20px;\n}\n  \n.doc-link {\n        position: relative;\n        font-weight: 500;\n        color: #21A35B !important;\n        text-decoration: none !important;\n        display: block;\n    }\n\ndiv:not(.markdown-body) .doc-link:hover {\n            text-decoration: none;\n            color: #1043FA !important;\n            transform: translateX(0.2em);\n        }\n\n.overview-card-title1:hover {\n    cursor:pointer;\n    transform: none!important;\n}\n\n    div:not(.markdown-body) .doc-link_arrow {\n        display: inline-block;\n        height: 1em;\n        width: auto;\n        vertical-align: middle;\n        margin-left: 0.2em;\n        margin-top: -0.1em;\n    }\n  \n     div:not(.markdown-body) .doc-link:hover .doc-link_arrow-color {\n            fill: #1043FA !important;\n        }\n  \n  \n/* Media Queries para dispositivos móviles */\n@media (max-width: 768px) {\n  .main {\n    grid-template-columns: repeat(2, 1fr); /* Dos columnas en pantallas medianas */\n  }\n}\n\n@media (max-width: 480px) {\n  .main {\n    grid-template-columns: 1fr; /* Una columna en pantallas pequeñas */\n}\n</style>\n  \n    <div class=\"main\">\n      \n    <!-- Individual -->\n      <div class=\"overview-card1\" onclick=\"parent.location='/docs/split-payments-platforms#payment-methods-and-fees'\">\n    <div class=\"overview-card-bottom-side\">\n             <div class=\"overview-icon1\"><img width=\"48\" src=\"https://files.readme.io/9f6ebd73db571ab6c5bf5f09a51a8e7f77de4901c56081e8c5a7a580c4f82844-receipt.svg\"  alt=\"\" loading=\"lazy\"><div class=\"img_overlay img_color_rgba(0,0,0,.2)\"></div></div>\n           <h3 class=\"overview-card-title1\">Payments methods <br>& fees</h3>\n          <p class=\"overview-card-content1\">\n             Learn about available payment methods and fee types.  \n        </p>\n          <a href=\"#payment-methods-and-fees\" class=\"doc-link\">Payment methods</a>\n          <a href=\"#fee-liability\" class=\"doc-link\">Fee liability</a>\n        </div>\n      </div> \n\n     <!-- Split at sales -->\n      <div class=\"overview-card1\" onclick=\"parent.location='/docs/split-payments-platforms#split-at-sales'\">\n     <div class=\"overview-card-bottom-side\">\n       <div class=\"overview-icon1\"><img width=\"48\" src=\"https://files.readme.io/957a8c4fcc660bfcbed6deb2954fb3e25c5289532138f606baab9950f70fc3ca-social-distancing.svg\"  alt=\"\" loading=\"lazy\"><div class=\"img_overlay img_color_rgba(0,0,0,.2)\"></div></div>\n           <h3 class=\"overview-card-title1\">Split at sales</h3>\n          <p class=\"overview-card-content1\">\n         <br> Split the funds into different accounts when the payment is made.\n        </p>\n          <a href=\"#split-at-sales\" class=\"doc-link\">Read information</a>\n        </div>\n      </div>\n      \n      <!-- Auth & capture -->\n      <div\n        class=\"overview-card2\" onclick=\"parent.location='/docs/split-payments-platforms#split-at-authorizations-and-captures'\">\n        <div class=\"overview-card-bottom-side\">\n                 <div class=\"overview-icon1\"><img width=\"48\" src=\"https://files.readme.io/a52e7337f5ba25d329692a01aa2dd03f222a4821e4f735458f20b77605dca8bb-sliders-v.svg\"  alt=\"\" loading=\"lazy\"><div class=\"img_overlay img_color_rgba(0,0,0,.2)\"></div></div>\n           <h3 class=\"overview-card-title1\">Split at authorizations <br>& captures</h3>\n          <p class=\"overview-card-content1\">\n           Understand payment authorization and capture scenarios.\n          </p>\n          <a href=\"#split-at-authorizations-and-captures\" class=\"doc-link\">Read information</a>\n        </div>\n      </div>  \n      \n      \n    </div>"
}
[/block]

***

# Payment methods and fees

## Payment methods

The availability of payment methods supported by dLocal may differ from country to country.

All of them are available for Split payment. If you would like to view detailed information for each country, please refer to the [Coverage](https://docs.dlocal.com/docs/payment-method#payment-methods-by-country) section.

## Fee liability

There could be various types of fees between dLocal and the business, such as:

* Processing fee
* Installment fee
* Advancement fee

### Rules definition

We can assist you in deciding which account will be charged.

* **User account**: The fee will be calculated based on a percentage of the amount sent, which will be split among the relevant accounts as specified in the Splits Object.
* **Liable account**: The whole amount will be charged from the Liable account that is configured under the Platform account.

# Split at sales

The Platform account owns the solution and handles payments and funds for itself and its User accounts. When making the payment, two parties are taken into account:

1. **Standard payment flow**. The [Payins solution](https://docs.dlocal.com/docs/overview-payins) standard flow is used to accept funds from cards and alternative payment methods.
2. **Split payment configuration**. You need to include the [Splits Object](https://docs.dlocal.com/docs/split-payments-platforms#splits-object) so that funds will be split into different accounts according to your request and its configurations.

## Request information detail

When [creating a payment](https://docs.dlocal.com/reference/create-payment), it is necessary to include these fields of the Splits Object in the request:

### Splits Object

Inside the object, you can add the number of IDs you need.

| Body Parameter | Type   | Required? | Description                                                                                                 |
| :------------- | :----- | :-------- | :---------------------------------------------------------------------------------------------------------- |
| `account_id`   | String | Yes       | Destination account’s ID.<br> This ID can belong to either a User account or a Liable account, as required. |
| `amount`       | Number | Yes       | Amount information in the currency of the payment.                                                          |

<br />

> The split can be made between multiple User accounts, not only between the Platform account and one unique User account.
>
> Refunds and chargebacks will use the same split information sent in the payment creation.

## Example Request

The following example splits a payment between two Seller accounts (`qwertyuiop12345A` and `qwertyuiop12345B`) and one Liable account (`qwertyuiop12345XB`):

```json Split payment example
{
  "amount": 100.00,
  "currency": "BRL",
  "country": "BR",
  "payment_method_id": "CARD",
  "payment_method_flow": "DIRECT",
  "payer": {
    "name": "Thiago Gabriel",
    "email": "thiago@example.com",
    "document": "53033315550"
  },
  "card": {
    "holder_name": "Thiago Gabriel",
    "number": "4111111111111111",
    "cvv": "123",
    "expiration_month": 10,
    "expiration_year": 2040,
    "capture": "false"
  },
  "order_id": "657434343",
  "splits": [
    {
      "account_id": "qwertyuiop12345A",
      "amount": 20.00
    },
    {
      "account_id": "qwertyuiop12345B",
      "amount": 30.00
    },
    {
      "account_id": "qwertyuiop12345XB",
      "amount": 50.00
    }
  ]
}
```

After payments are made, the funds will be registered in the destination account but will remain in transit until reaching the settlement period. Then the funds will become available for movement.

# Split at authorizations and captures

When conducting authorization and capture transactions, it's necessary to send the [Splits Object](https://docs.dlocal.com/docs/split-payments-platforms#splits-object) in both authorization and capture requests.

The purposes are:

* The split of an authorization is used to calculate fees and taxes. It does not indicate the final amounts to be transferred to the destination MIDs.
* The split of the capture represents the effective transfer of funds.

## Capture types

Here are some scenarios for capturing payments and instructions on how to send the Splits Object accordingly:

| Type                           | Details                                                                                                                                                                                                                                                                                                      |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Full** **amount** capture    | We consider a full amount capture when the capture amount is the same as the authorization. Include the Splits Object in both authorization and capture requests.                                                                                                                                            |
| **Partial** **amount** capture | If you capture only a partial amount compared to the authorization step, send the new Splits Object in the capture request, and the amount cannot exceed the one in the authorization for each account. For multiple captures, the total amount cannot exceed the one in the authorization for each account. |
| **Partial account** capture    | If you only capture part of the accounts, send the new Splits Object in the capture request. The account ids should be the ones that were included in the auth requests.                                                                                                                                     |

## Create an authorization

> The following is an extension of the [Authorization API documentation](https://docs.dlocal.com/reference/create-authorization).

Request fields, response fields, and error codes are the same as split at sales. The main difference is that, since it is an authorization and not a sale, we have to set the `capture` field as `false`.

### Example request

To create an authorization, simply [create a regular card payment](https://docs.dlocal.com/reference/create-payment) with the parameter `capture = FALSE` within the Card object and add the Splits Object.

```json Example request | Create an split authorization
{
  "amount": 100.00,
  "currency": "BRL",
  "country": "BR",
  "payment_method_id": "CARD",
  "payment_method_flow": "DIRECT",
  "payer": {
    "name": "Thiago Gabriel",
    "email": "thiago@example.com",
    "document": "53033315550"
  },
  "card": {
    "holder_name": "Thiago Gabriel",
    "number": "4111111111111111",
    "cvv": "123",
    "expiration_month": 10,
    "expiration_year": 2040,
    "capture": "false"
  },
  "order_id": "657434343",
  "splits": [
    {
      "account_id": "AC-5678-1234-5432",
      "amount": 50
    },
    {
      "account_id": "AC-6789-3344-1122",
      "amount": 50
    }
  ]
}
```
```json Example response | Create an split authorization
{
  "id": "D-4-e2227981-8ec8-48fd-8e9a-19fedb08d73a",
  "amount": 100,
  "currency": "BRL",
  "payment_method_id": "CARD",
  "payment_method_type": "CARD",
  "payment_method_flow": "DIRECT",
  "country": "BR",
  "card": {
    "holder_name": "Thiago Gabriel",
    "expiration_month": 10,
    "expiration_year": 2040,
    "brand": "VI",
    "last4": "1111"
  },
  "created_date": "2019-02-06T21:04:43.000+0000",
  "approved_date": "2019-02-06T21:04:44.000+0000",
  "status": "AUTHORIZED",
  "status_detail": "The payment was authorized",
  "status_code": "600",
  "order_id": "657434343",
  "notification_url": "http://merchant.com/notifications"
}
```

## Capture an authorization

> The following is an extension of the [Authorization API documentation](https://docs.dlocal.com/reference/capture-authorization).

Splits Object must be included in the request. The amount included in the Splits Object cannot be higher than the amount authorized for each account individually.

### Example request

```json Example request | Capture an split authorization
{
  "authorization_id": "PAY2323243343543",
  "amount": 100.00,
  "country": "BR",
  "order_id": "657434343",
  "splits": [
    {
      "account_id": "AC-5678-1234-5432",
      "amount": 50
    },
    {
      "account_id": "AC-6789-3344-1122",
      "amount": 50
    }
  ]
}
```
```json Example response | Capture an split authorization
{
  "id": "D-4-09f52dd0-5cfa-4b0e-a471-1608ea0dba24",
  "amount": 100.00,
  "currency": "BRL",
  "country": "BR",
  "created_date": "2019-02-07T13:47:06.000+0000",
  "approved_date": "2019-02-07T13:47:06.000+0000",
  "status": "PAID",
  "status_detail": "The payment was paid",
  "status_code": "200",
  "order_id": "657434343",
  "authorization_id": "PAY2323243343543"
}
```