Crear cobro parcial

Crea un cobro parcial para una transacción existente.

Endpoint

POST {{base_url}}/transaction/installment

Headers

Name	Value
Content-Type*	application/json
x-auth-token*	{token}
child-id	{business_id}

child-id es opcional y solo aplica para cuentas administradas.

Body

Campo	Tipo	Obligatorio	Descripción
external_reference	String	Sí	Referencia externa del cobro al que se aplicará el abono.
amount	Number	Sí	Valor del abono. Debe ser estrictamente mayor a 0 y menor al saldo disponible del cobro.

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

{
  "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

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.