> For the complete documentation index, see [llms.txt](https://docs.qentaz.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qentaz.com/documentation/cobros/crear-cobro-multiple.md).

# Consolidar cobros

Agrupa varios cobros en un único enlace de pago. Puedes elegir entre dos opciones:

* **Consolidar cobros creados:** agrupa cobros que ya existen.
* **Consolidar y crear cobros en una solicitud:** crea cobros nuevos y, si lo necesitas, combínalos con cobros existentes.

Usa una sola opción por solicitud: no envíes `external_references` y `transactions` al mismo tiempo.

Agrupa varios cobros en un único enlace de pago. Puedes elegir entre dos opciones:

* **Consolidar cobros creados:** agrupa cobros que ya existen.
* **Consolidar y crear cobros en una solicitud:** crea cobros nuevos y, si lo necesitas, combínalos con cobros existentes.

Usa una sola opción por solicitud: no envíes `external_references` y `transactions` al mismo tiempo.

Para crear cobros independientes en una sola solicitud, consulta [Crear cobros masivos](https://docs.qentaz.com/documentation/cobros/generar-cobros-masivos.md).

## Endpoint

<mark style="color:green;">`POST`</mark> `{{base_url}}/transaction/multipayment`

## Headers

| Nombre            | Obligatorio | Descripción                                                                                                                                           |
| ----------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type`    | Sí          | `application/json`.                                                                                                                                   |
| `x-auth-token`    | Sí          | Token de autenticación.                                                                                                                               |
| `child-id`        | No          | Identificador de la cuenta administrada en la que se crea el consolidado.                                                                             |
| `idempotency-key` | No          | Clave para identificar la solicitud y rechazar duplicados del mismo comercio durante el día. No aplica cuando se envía una sola referencia existente. |

## Campos comunes

Estos campos son opcionales en las dos modalidades y se envían en la raíz del body.

| Campo                    | Tipo   | Descripción                                                                                                                                                                                                              |
| ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `description`            | String | Descripción visible del consolidado. No se admite con una sola referencia existente.                                                                                                                                     |
| `reference_one`          | String | Referencia visible del consolidado. No se admite con una sola referencia existente.                                                                                                                                      |
| `return_url`             | String | URL a la que se redirige al pagador al completar el pago.                                                                                                                                                                |
| `existing_consolidation` | String | `cancel` (por defecto) reemplaza los consolidados anteriores cuando es posible; `reject` rechaza la solicitud si existe uno vigente. Consulta [Reemplazar un consolidado anterior](#reemplazar-un-consolidado-anterior). |

## Consolidar cobros creados

Crea un enlace único para cobrar varias transacciones que ya fueron creadas. Envía sus referencias externas en `external_references`.

### Campos del body

Además de los [campos comunes](#campos-comunes), envía:

| Campo                 | Tipo             | Obligatorio | Descripción                                                                                              |
| --------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
| `external_references` | Array de strings | Sí          | De 1 a 25 referencias existentes y únicas. Las referencias y sus comas no pueden superar 256 caracteres. |

Los cobros deben tener el mismo pagador y moneda, estar en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED` y no ser de tipo `multipayment`. Se pueden mezclar cobros del comercio seleccionado y de un negocio partner autorizado.

### Ejemplo de solicitud

```bash
curl --location --request POST '{{base_url}}/transaction/multipayment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "external_references": ["TRX-001", "TRX-002"],
    "existing_consolidation": "cancel",
    "description": "Pago del pedido",
    "reference_one": "Pedido 12345",
    "return_url": "https://comercio.com/pago-completado"
  }'
```

### Respuestas exitosas - 200

```json
{
  "external_reference": "ABC123DEF",
  "reference_one": "Pedido 12345",
  "link": "https://pago.trazo.co/mi-comercio/t/ABC123DEF",
  "process_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-08-17T10:30:00-05:00"
}
```

Si se envía una sola referencia existente, se devuelve el enlace individual y no se crea un nuevo consolidado. Primero se aplica la política `existing_consolidation`:

```json
{
  "external_reference": "TRX-001",
  "reference_one": "1 transacción",
  "link": "https://pago.trazo.co/mi-comercio/t/TRX-001",
  "created_at": "2026-08-17T10:30:00-05:00"
}
```

### Respuestas de error

Esta modalidad puede responder `400`, `401`, `403` o `409`. Consulta los ejemplos y sus causas en [Errores](#errores).

## Consolidar y crear cobros en una solicitud

Usa `transactions` para crear cobros nuevos, combinar cobros nuevos y existentes, o agrupar cobros existentes.

### Campos del body

Además de los [campos comunes](#campos-comunes), envía:

| Campo                                                    | Tipo             | Obligatorio | Descripción                                                                                                                                                                                                                |
| -------------------------------------------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transactions`                                           | Array de objetos | Sí          | De 2 a 25 cobros nuevos o existentes. Cada elemento representa un cobro.                                                                                                                                                   |
| `currency`                                               | String           | Sí          | Moneda común a los cobros nuevos y existentes. Se envía en la raíz y no dentro de cada elemento.                                                                                                                           |
| `payer`                                                  | Object           | Sí          | Datos compartidos del pagador. Se envían en la raíz y deben coincidir con los cobros existentes.                                                                                                                           |
| `merchant_email`, `merchant_phone`, `merchant_id_number` | String           | Condicional | Identifican al usuario creador de los cobros nuevos. Para cada cobro nuevo se requiere al menos uno, en la raíz o en el elemento. Si el elemento envía identificadores propios, se usan estos en lugar de los compartidos. |

#### Pagador `payer`

El objeto debe incluir al menos `phone`, `email` o `user_id_number`. Si envías cualquiera de los campos de identificación, debes enviar los tres: `user_id_number`, `user_id_type` y `first_name`.

| Campo                  | Tipo   | Descripción                                                       |
| ---------------------- | ------ | ----------------------------------------------------------------- |
| `payer.phone`          | String | Teléfono del pagador con código de país. Ejemplo: `573111222333`. |
| `payer.email`          | String | Correo del pagador.                                               |
| `payer.user_id_number` | String | Número de documento.                                              |
| `payer.user_id_type`   | String | Tipo de documento.                                                |
| `payer.first_name`     | String | Nombre usado para validar el documento.                           |

#### Elementos de `transactions`

Cada elemento representa un cobro existente o un cobro nuevo:

| Campo                                                    | Tipo    | Obligatorio                | Descripción                                                                                                                                                                                |
| -------------------------------------------------------- | ------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `external_reference`                                     | String  | Sí para un cobro existente | Referencia de un cobro existente. No la combines con otros campos en el mismo elemento.                                                                                                    |
| `amount`                                                 | Number  | Sí para un cobro nuevo     | Valor del cobro.                                                                                                                                                                           |
| `description`                                            | String  | Sí para un cobro nuevo     | Descripción del cobro individual.                                                                                                                                                          |
| `child_id`                                               | String  | No                         | Cuenta administrada a la que pertenece el cobro nuevo. Sin el header `child-id`, si se omite pertenece al comercio principal. La cuenta debe estar administrada por el comercio principal. |
| `merchant_email`, `merchant_phone`, `merchant_id_number` | String  | Condicional                | Identifican al usuario creador de este cobro. Se requiere al menos uno si no se envía un identificador compartido en la raíz.                                                              |
| `status`                                                 | String  | No                         | Estado inicial. Por defecto: `PENDING`.                                                                                                                                                    |
| `user_notification`                                      | Boolean | No                         | Define si se envía la notificación del cobro individual.                                                                                                                                   |

Un cobro nuevo también admite los demás campos aplicables de [Generar Cobro](https://docs.qentaz.com/documentation/cobros/generar-cobro.md), excepto `currency` y `payer`, que se envían en la raíz.

Si usas `child-id` en el header, no incluyas `child_id` en los elementos y los cobros existentes deben pertenecer a la cuenta seleccionada. Sin el header, cada cuenta indicada en el cuerpo debe estar administrada por el comercio principal.

Los cobros existentes deben estar en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED`, no ser de tipo `multipayment` y coincidir con la moneda y el pagador de la raíz.

### Ejemplo de solicitud

```bash
curl --location --request POST '{{base_url}}/transaction/multipayment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "currency": "COP",
    "payer": { "phone": "573111222333" },
    "merchant_email": "operaciones@partner.com",
    "description": "Pago de productos y servicios",
    "reference_one": "Pedido 12345",
    "transactions": [
      { "external_reference": "TRX-EXISTENTE-001" },
      { "child_id": "MARCA-A", "amount": 30000, "description": "Productos marca A" },
      { "amount": 10000, "description": "Servicio del partner" }
    ]
  }'
```

### Respuesta exitosa - 200

```json
{
  "external_reference": "ABC123DEF",
  "link": "https://pago.trazo.co/mi-comercio/t/ABC123DEF",
  "process_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-08-17T10:30:00-05:00",
  "transactions": [
    { "position": 0, "external_reference": "TRX-EXISTENTE-001", "business_id": "PARTNER" },
    { "position": 1, "external_reference": "TRX-NUEVO-001", "business_id": "MARCA-A" },
    { "position": 2, "external_reference": "TRX-NUEVO-002", "business_id": "PARTNER" }
  ],
  "canceled_consolidations": ["M1"]
}
```

Cada elemento de `transactions` indica la posición original, la referencia y el comercio del cobro. `canceled_consolidations` contiene las referencias de los consolidados cancelados; es una lista vacía si no hubo cancelaciones.

### Respuestas de error

Esta modalidad puede responder `400`, `401`, `403` o `409`. Consulta los ejemplos y sus causas en [Errores](#errores).

Si falla un elemento, se rechaza toda la solicitud: no se crea el consolidado ni se modifican las asociaciones de los cobros existentes.

## Reemplazar un consolidado anterior

La política `existing_consolidation` se aplica a ambas modalidades:

* `cancel` (por defecto): cancela los consolidados anteriores en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED`. Los cobros omitidos quedan disponibles si son pagables.
* `reject`: rechaza la solicitud con 409 si algún consolidado anterior sigue vigente.

Si un consolidado anterior está en `PROCESSING`, la API responde 409 y conserva sus asociaciones. Un consolidado `CANCELED` permite liberar asociaciones residuales; otros estados no permiten reemplazarlo. Si alguno de los cobros omitidos no es pagable, se rechaza la solicitud completa.

| Caso                                 | Resultado con `cancel`                        |
| ------------------------------------ | --------------------------------------------- |
| Anterior A, B; nuevo A, B            | Se cancela el anterior y se agrupan A y B.    |
| Anterior A, B; nuevo A, B, C         | Se cancela el anterior y se agrupan A, B y C. |
| Anterior A, B, C; nuevo A, B         | Se cancela el anterior y C queda disponible.  |
| Anterior A, B; nuevo B, C            | Se cancela el anterior y A queda disponible.  |
| Anteriores A, B y C, D; nuevo B, C   | Se cancelan ambos; A y D quedan disponibles.  |
| Un cobro solicitado ya está pagado   | Error 400; no se cancela ni se crea nada.     |
| Consolidado anterior en `PROCESSING` | Error 409; no se modifica nada.               |
| `reject` con un consolidado vigente  | Error 409; el anterior permanece intacto.     |

| Nombre            | Obligatorio | Descripción                                                                                                                                           |
| ----------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type`    | Sí          | `application/json`.                                                                                                                                   |
| `x-auth-token`    | Sí          | Token de autenticación.                                                                                                                               |
| `child-id`        | No          | Identificador de la cuenta administrada en la que se crea el consolidado.                                                                             |
| `idempotency-key` | No          | Clave para identificar la solicitud y rechazar duplicados del mismo comercio durante el día. No aplica cuando se envía una sola referencia existente. |

## Campos comunes

Estos campos son opcionales en las dos modalidades y se envían en la raíz del body.

| Campo                    | Tipo   | Descripción                                                                                                                                                                                                              |
| ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `description`            | String | Descripción visible del consolidado. No se admite con una sola referencia existente.                                                                                                                                     |
| `reference_one`          | String | Referencia visible del consolidado. No se admite con una sola referencia existente.                                                                                                                                      |
| `return_url`             | String | URL a la que se redirige al pagador al completar el pago.                                                                                                                                                                |
| `existing_consolidation` | String | `cancel` (por defecto) reemplaza los consolidados anteriores cuando es posible; `reject` rechaza la solicitud si existe uno vigente. Consulta [Reemplazar un consolidado anterior](#reemplazar-un-consolidado-anterior). |

## Consolidar cobros creados

Crea un enlace único para cobrar varias transacciones que ya fueron creadas. Envía sus referencias externas en `external_references`.

### Campos del body

Además de los [campos comunes](#campos-comunes), envía:

| Campo                 | Tipo             | Obligatorio | Descripción                                                                                              |
| --------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
| `external_references` | Array de strings | Sí          | De 1 a 25 referencias existentes y únicas. Las referencias y sus comas no pueden superar 256 caracteres. |

Los cobros deben tener el mismo pagador y moneda, estar en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED` y no ser de tipo `multipayment`. Se pueden mezclar cobros del comercio seleccionado y de un negocio partner autorizado.

### Ejemplo de solicitud

```bash
curl --location --request POST '{{base_url}}/transaction/multipayment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "external_references": ["TRX-001", "TRX-002"],
    "existing_consolidation": "cancel",
    "description": "Pago del pedido",
    "reference_one": "Pedido 12345",
    "return_url": "https://comercio.com/pago-completado"
  }'
```

### Respuestas exitosas - 200

```json
{
  "external_reference": "ABC123DEF",
  "reference_one": "Pedido 12345",
  "link": "https://pago.trazo.co/mi-comercio/t/ABC123DEF",
  "process_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-08-17T10:30:00-05:00"
}
```

Si se envía una sola referencia existente, se devuelve el enlace individual y no se crea un nuevo consolidado. Primero se aplica la política `existing_consolidation`:

```json
{
  "external_reference": "TRX-001",
  "reference_one": "1 transacción",
  "link": "https://pago.trazo.co/mi-comercio/t/TRX-001",
  "created_at": "2026-08-17T10:30:00-05:00"
}
```

### Respuestas de error

Esta modalidad puede responder `400`, `401`, `403` o `409`. Consulta los ejemplos y sus causas en [Errores](#errores).

## Consolidar y crear cobros en una solicitud

Usa `transactions` para crear cobros nuevos, combinar cobros nuevos y existentes, o agrupar cobros existentes.

### Campos del body

Además de los [campos comunes](#campos-comunes), envía:

| Campo                                                    | Tipo             | Obligatorio | Descripción                                                                                                                                                                                                                |
| -------------------------------------------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transactions`                                           | Array de objetos | Sí          | De 2 a 25 cobros nuevos o existentes. Cada elemento representa un cobro.                                                                                                                                                   |
| `currency`                                               | String           | Sí          | Moneda común a los cobros nuevos y existentes. Se envía en la raíz y no dentro de cada elemento.                                                                                                                           |
| `payer`                                                  | Object           | Sí          | Datos compartidos del pagador. Se envían en la raíz y deben coincidir con los cobros existentes.                                                                                                                           |
| `merchant_email`, `merchant_phone`, `merchant_id_number` | String           | Condicional | Identifican al usuario creador de los cobros nuevos. Para cada cobro nuevo se requiere al menos uno, en la raíz o en el elemento. Si el elemento envía identificadores propios, se usan estos en lugar de los compartidos. |

#### Pagador `payer`

El objeto debe incluir al menos `phone`, `email` o `user_id_number`. Si envías cualquiera de los campos de identificación, debes enviar los tres: `user_id_number`, `user_id_type` y `first_name`.

| Campo                  | Tipo   | Descripción                                                       |
| ---------------------- | ------ | ----------------------------------------------------------------- |
| `payer.phone`          | String | Teléfono del pagador con código de país. Ejemplo: `573111222333`. |
| `payer.email`          | String | Correo del pagador.                                               |
| `payer.user_id_number` | String | Número de documento.                                              |
| `payer.user_id_type`   | String | Tipo de documento.                                                |
| `payer.first_name`     | String | Nombre usado para validar el documento.                           |

#### Elementos de `transactions`

Cada elemento representa un cobro existente o un cobro nuevo:

| Campo                                                    | Tipo    | Obligatorio                | Descripción                                                                                                                                                                                |
| -------------------------------------------------------- | ------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `external_reference`                                     | String  | Sí para un cobro existente | Referencia de un cobro existente. No la combines con otros campos en el mismo elemento.                                                                                                    |
| `amount`                                                 | Number  | Sí para un cobro nuevo     | Valor del cobro.                                                                                                                                                                           |
| `description`                                            | String  | Sí para un cobro nuevo     | Descripción del cobro individual.                                                                                                                                                          |
| `child_id`                                               | String  | No                         | Cuenta administrada a la que pertenece el cobro nuevo. Sin el header `child-id`, si se omite pertenece al comercio principal. La cuenta debe estar administrada por el comercio principal. |
| `merchant_email`, `merchant_phone`, `merchant_id_number` | String  | Condicional                | Identifican al usuario creador de este cobro. Se requiere al menos uno si no se envía un identificador compartido en la raíz.                                                              |
| `status`                                                 | String  | No                         | Estado inicial. Por defecto: `PENDING`.                                                                                                                                                    |
| `user_notification`                                      | Boolean | No                         | Define si se envía la notificación del cobro individual.                                                                                                                                   |

Un cobro nuevo también admite los demás campos aplicables de [Generar Cobro](https://docs.qentaz.com/documentation/cobros/generar-cobro.md), excepto `currency` y `payer`, que se envían en la raíz.

Si usas `child-id` en el header, no incluyas `child_id` en los elementos y los cobros existentes deben pertenecer a la cuenta seleccionada. Sin el header, cada cuenta indicada en el cuerpo debe estar administrada por el comercio principal.

Los cobros existentes deben estar en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED`, no ser de tipo `multipayment` y coincidir con la moneda y el pagador de la raíz.

### Ejemplo de solicitud

```bash
curl --location --request POST '{{base_url}}/transaction/multipayment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "currency": "COP",
    "payer": { "phone": "573111222333" },
    "merchant_email": "operaciones@partner.com",
    "description": "Pago de productos y servicios",
    "reference_one": "Pedido 12345",
    "transactions": [
      { "external_reference": "TRX-EXISTENTE-001" },
      { "child_id": "MARCA-A", "amount": 30000, "description": "Productos marca A" },
      { "amount": 10000, "description": "Servicio del partner" }
    ]
  }'
```

### Respuesta exitosa - 200

```json
{
  "external_reference": "ABC123DEF",
  "link": "https://pago.trazo.co/mi-comercio/t/ABC123DEF",
  "process_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-08-17T10:30:00-05:00",
  "transactions": [
    { "position": 0, "external_reference": "TRX-EXISTENTE-001", "business_id": "PARTNER" },
    { "position": 1, "external_reference": "TRX-NUEVO-001", "business_id": "MARCA-A" },
    { "position": 2, "external_reference": "TRX-NUEVO-002", "business_id": "PARTNER" }
  ],
  "canceled_consolidations": ["M1"]
}
```

Cada elemento de `transactions` indica la posición original, la referencia y el comercio del cobro. `canceled_consolidations` contiene las referencias de los consolidados cancelados; es una lista vacía si no hubo cancelaciones.

### Respuestas de error

Esta modalidad puede responder `400`, `401`, `403`, `409` o `503`. Consulta los ejemplos y sus causas en [Errores](#errores).

Si falla un elemento, se rechaza toda la solicitud: no se crea el consolidado ni se modifican las asociaciones de los cobros existentes.

## Reemplazar un consolidado anterior

La política `existing_consolidation` se aplica a ambas modalidades:

* `cancel` (por defecto): cancela los consolidados anteriores en `CREATED`, `SCHEDULED`, `PENDING` o `FAILED`. Los cobros omitidos quedan disponibles si son pagables.
* `reject`: rechaza la solicitud con 409 si algún consolidado anterior sigue vigente.

Si un consolidado anterior está en `PROCESSING`, la API responde 409 y conserva sus asociaciones. Un consolidado `CANCELED` permite liberar asociaciones residuales; otros estados no permiten reemplazarlo. Si alguno de los cobros omitidos no es pagable, se rechaza la solicitud completa.

| Caso                                 | Resultado con `cancel`                        |
| ------------------------------------ | --------------------------------------------- |
| Anterior A, B; nuevo A, B            | Se cancela el anterior y se agrupan A y B.    |
| Anterior A, B; nuevo A, B, C         | Se cancela el anterior y se agrupan A, B y C. |
| Anterior A, B, C; nuevo A, B         | Se cancela el anterior y C queda disponible.  |
| Anterior A, B; nuevo B, C            | Se cancela el anterior y A queda disponible.  |
| Anteriores A, B y C, D; nuevo B, C   | Se cancelan ambos; A y D quedan disponibles.  |
| Un cobro solicitado ya está pagado   | Error 400; no se cancela ni se crea nada.     |
| Consolidado anterior en `PROCESSING` | Error 409; no se modifica nada.               |
| `reject` con un consolidado vigente  | Error 409; el anterior permanece intacto.     |

## Errores

### Solicitud inválida o cobro no pagable - 400

Incluye referencias duplicadas, datos inválidos, moneda o pagador diferentes, un cobro que no está disponible o una clave de idempotencia duplicada. Por ejemplo:

```json
{
  "error": "Existing transactions must be payable, in the same currency, and belong to the same payer."
}
```

Los errores de validación del cuerpo pueden devolver una lista con el campo, valor, mensaje y posición:

```json
{
  "error": [
    {
      "field": "child-id",
      "value": "MARCA-A",
      "message": "\"transactions[1].child-id\" no es válido en el cuerpo; usa \"child_id\" con guion bajo.",
      "position": 1
    }
  ]
}
```

### Consolidado anterior vigente con `reject` - 409

```json
{ "error": "CONSOLIDATION_EXISTS: An existing consolidated payment is active." }
```

### Consolidado anterior en procesamiento - 409

```json
{ "error": "PAYMENT_IN_PROGRESS: The existing consolidated payment is processing." }
```

También se devuelve 409 si el consolidado anterior no puede reemplazarse o contiene un cobro omitido que no es pagable.

### Otros errores

* `401`: token ausente, vencido o inválido.
* `403`: una cuenta administrada o un cobro no está autorizado.

### Solicitud inválida o cobro no pagable - 400

Incluye referencias duplicadas, datos inválidos, moneda o pagador diferentes, un cobro que no está disponible o una clave de idempotencia duplicada. Por ejemplo:

```json
{
  "error": "Existing transactions must be payable, in the same currency, and belong to the same payer."
}
```

Los errores de validación del cuerpo pueden devolver una lista con el campo, valor, mensaje y posición:

```json
{
  "error": [
    {
      "field": "child-id",
      "value": "MARCA-A",
      "message": "\"transactions[1].child-id\" no es válido en el cuerpo; usa \"child_id\" con guion bajo.",
      "position": 1
    }
  ]
}
```

### Consolidado anterior vigente con `reject` - 409

```json
{ "error": "CONSOLIDATION_EXISTS: An existing consolidated payment is active." }
```

### Consolidado anterior en procesamiento - 409

```json
{ "error": "PAYMENT_IN_PROGRESS: The existing consolidated payment is processing." }
```

También se devuelve 409 si el consolidado anterior no puede reemplazarse o contiene un cobro omitido que no es pagable.

### Otros errores

* `401`: token ausente, vencido o inválido.
* `403`: una cuenta administrada o un cobro no está autorizado.
* `503`: la modalidad `transactions` no está habilitada en el entorno.
