> 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).

# Crear cobro múltiple

Agrupa varios cobros activos en un único enlace de pago.

## Endpoint

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

## Headers

| Name                                                 | Value              |
| ---------------------------------------------------- | ------------------ |
| `Content-Type`<mark style="color:red;">**\***</mark> | `application/json` |
| `x-auth-token`<mark style="color:red;">**\***</mark> | `{token}`          |
| `child-id`                                           | `{business_id}`    |

{% hint style="info" %}
`child-id` es opcional y solo aplica para cuentas administradas.
{% endhint %}

## Body

<table><thead><tr><th width="210.76953125">Campo</th><th width="132.41015625">Tipo</th><th width="121.81640625">Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td><code>external_references</code></td><td>Array</td><td>Sí</td><td>Referencias externas que se agruparán. Debe contener entre 1 y 25 referencias únicas.</td></tr><tr><td><code>return_url</code></td><td>String</td><td>No</td><td>URL de redirección una vez finalice el pago.</td></tr></tbody></table>

## Validaciones

Todas las referencias deben:

* Corresponder al mismo pagador y a la misma moneda.
* Estar en estado `CREATED`, `SCHEDULED`, `PENDING` o `FAILED`.
* No ser previamente una transacción de tipo `multipayment`.

Cuando se recibe una sola referencia, la API devuelve el enlace existente y no crea un nuevo cobro.

Al completarse el pago, si tienes activado los webhooks, recibirás al custom\_webhook o webhook general del comercio, los eventos para cada uno de los pagos. El evento del cobro múltiple no se dispará.

## Respuesta exitosa

```json
{
  "external_reference": "ABC123DEF",
  "reference_one": "2 transacciones",
  "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"
}
```

## Ejemplo

```bash
curl --location --request POST '{{base_url}}/transaction/multipayment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "external_references": [
      "U82R43P98",
      "GG2095328"
    ],
    "return_url": "https://mi-comercio.com/pago-completado"
  }'
```

## Errores

* `400`: referencias duplicadas, de otro comercio, de distinto pagador o moneda, no pagables, o listado mayor a 256 caracteres.
* `401`: token ausente, vencido o inválido.
* `403`: el cliente no tiene permiso para este endpoint.