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

# Crear cobro parcial

Crea un cobro parcial para una transacción existente.

## Endpoint

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

## 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>Campo</th><th width="132.109375">Tipo</th><th width="115.0390625">Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td><code>external_reference</code></td><td>String</td><td>Sí</td><td>Referencia externa del cobro al que se aplicará el abono.</td></tr><tr><td><code>amount</code></td><td>Number</td><td>Sí</td><td>Valor del abono. Debe ser estrictamente mayor a 0 y menor al saldo disponible del cobro.</td></tr></tbody></table>

## Comportamiento

La transacción original debe estar en un estado modificable. Al procesar el abono:

1. Reduce el saldo de la transacción original.
2. Crea una nueva transacción de abono por el valor enviado.
3. Genera un enlace de pago para el abono con método digital y sin notificación automática.

## Respuesta exitosa

```json
{
  "external_reference": "ABONO12345",
  "source_external_reference": "I8068C328",
  "amount": 25000,
  "link": "https://pago.trazo.co/mi-comercio/t/ABONO12345",
  "created_at": "2026-08-17T10:30:00-05:00"
}
```

## Ejemplo

```bash
curl --location --request POST '{{base_url}}/transaction/installment' \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: {token}' \
  --data '{
    "external_reference": "I8068C328",
    "amount": 25000
  }'
```

## Errores

* `400`: referencia inexistente para el comercio, estado no modificable, transacción fraccionada o valor de abono no permitido.
* `401`: token ausente, vencido o inválido.
* `403`: el cliente no tiene permiso para este endpoint.