Crear cobro múltiple

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

Endpoint

POST {{base_url}}/transaction/multipayment

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_references	Array	Sí	Referencias externas que se agruparán. Debe contener entre 1 y 25 referencias únicas.
return_url	String	No	URL de redirección una vez finalice el pago.

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

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

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.