# API · Dividir liquidación (split)

> División de la liquidación de una orden entre varios comercios facilitados.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/procesos-operativos/split

```http
POST /api/v1/orders/liquidation/split
```

## Qué hace [#que-hace]

Divide la liquidación de una orden entre varios comercios. Solo aplica a comercios que usan Tilopay como facilitador de pago, y las órdenes resultantes se identifican con el prefijo `SL|`.

Reglas:

- Los comercios deben estar aprobados y ser del mismo país.
- Si la partición es menor al monto total de la orden, el restante se le asigna al comercio que realizó la transacción original.
- Solo aplica sobre órdenes aprobadas completamente.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

<Param id="split-parametro-order-id" name="order_id" type="string">
Id de la orden aprobada en Tilopay.
</Param>

<Param id="split-parametro-commerces" name="commerces" type="array">
Array asociativo con las llaves `email` y `amount` de cada comercio con el que se divide la liquidación. Incluir al comercio propietario es opcional: si no se especifica su monto, se le asigna el excedente de la partición, y si se incluye y hay excedente, se le suma.
</Param>

<Param id="split-parametro-lang" name="lang" type="string">
Idioma de la solicitud.
</Param>

## Ejemplo de request [#request]

Los valores `<...>` son marcadores: reemplazalos por tus credenciales y datos.

```json
{
  "order_id": "1",
  "commerces": [
    {
      "email": "commerce-1@example.com",
      "amount": "7.5"
    },
    {
      "email": "commerce-2@example.com",
      "amount": "5.5"
    }
  ],
  "lang": "en"
}
```

## Respuesta [#respuesta]

```json
{
  "type": "200",
  "message": "Great",
  "description": "Order splitted successfully",
  "response": {
    "total_order_splitted": 3,
    "order_id": 1,
    "order_number": "PFC000069-TYP785237_313",
    "order_key": "<api_key>",
    "order_currency": "USD",
    "order_amount": "33.00",
    "splitted_orders": [
      {
        "id": 1,
        "amount": 20,
        "commerce_name": "Commerce owner name",
        "commerce_email": "owner@example.com"
      },
      {
        "id": 2,
        "amount": 7.5,
        "commerce_name": "Commerce name",
        "commerce_email": "commerce-1@example.com"
      },
      {
        "id": 3,
        "amount": 5.5,
        "commerce_name": "Commerce name",
        "commerce_email": "commerce-2@example.com"
      }
    ]
  }
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).