Payout actualizado

{
  "type": "payout.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "payout:3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1:payment_submitted:payment_processed",
    "payoutId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "companyId": "cmp_123",
    "externalId": "ext-001",
    "onBehalfOf": "user-123",
    "previousState": "payment_submitted",
    "state": "payment_processed",
    "amount": 100000,
    "currency": "cop",
    "destinationType": "bank",
    "txHash": "0xabc123",
    "extraData": {
      "finalAmount": "99950",
      "finalAmountCurrency": "cop",
      "uetr": "97ed4827-7b6f-4b1a-9b0e-2a1c3d4e5f60",
      "trackingNumber": "TRK-0001"
    },
    "createdAt": "2026-06-23T11:00:00.000Z",
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

Tipo de evento: payout.updated

payout.updated reemplaza al evento payout.update (deprecado). Durante la migración se entregan ambos nombres para la misma transición —payout.updated (nuevo) y payout.update (heredado)—, así puedes migrar sin perder eventos. payout.update está deprecado y se eliminará el 15 de noviembre de 2026; cambia el manejo de payouts a payout.updated antes de esa fecha.

El type del evento es siempre payout.updated, sin importar la transición — lee data.state (y data.previousState) para saber qué pasó. Ver Resumen de webhooks para entrega, headers y verificación de firma.

Campos de `data`

string

Identificador estable de este evento de payout. El mismo valor se envía en el payout.update heredado durante la transición — úsalo para deduplicar los dos nombres.

string

El identificador del payout.

string

El identificador de tu empresa.

string

Tu referencia externa, si se proporcionó.

string

El usuario/entidad para quien se hizo el payout.

string | null

El estado previo a esta transición. Es null en el primer evento.

string

El estado actual del payout. Ver la tabla de abajo.

number

El monto del payout, en unidades mínimas (por ejemplo, centavos).

string

La moneda de destino.

string

Uno de wallet, bank o qr_code.

string

Presente solo cuando el payout falló.

string

Hash de la transacción on-chain. Presente para destinos wallet y bank.

object

Metadatos del riel bancario. Presente solo para destinationType = bank.

Mostrar extraData

string

Monto final liquidado.

string

Moneda del monto liquidado.

string

Referencia única de transacción de extremo a extremo (SEPA/SWIFT).

string

Número de seguimiento.

string

Marca de tiempo de creación (ISO 8601).

string

Marca de tiempo de última actualización (ISO 8601).

Estados del payout (`data.state`)

Estado	Significado
`created`	Payout creado
`in_review`	En revisión (pre-partner)
`awaiting_funds`	Esperando fondos
`funds_received`	Fondos recibidos
`payment_submitted`	Enviado / en proceso
`payment_processed`	Completado exitosamente
`undeliverable`	No entregable
`returned`	Devuelto
`refunded`	Reembolsado
`canceled`	Cancelado
`error`	Error / fallido

{
  "type": "payout.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "payout:3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1:payment_submitted:payment_processed",
    "payoutId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "companyId": "cmp_123",
    "externalId": "ext-001",
    "onBehalfOf": "user-123",
    "previousState": "payment_submitted",
    "state": "payment_processed",
    "amount": 100000,
    "currency": "cop",
    "destinationType": "bank",
    "txHash": "0xabc123",
    "extraData": {
      "finalAmount": "99950",
      "finalAmountCurrency": "cop",
      "uetr": "97ed4827-7b6f-4b1a-9b0e-2a1c3d4e5f60",
      "trackingNumber": "TRK-0001"
    },
    "createdAt": "2026-06-23T11:00:00.000Z",
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

Documentación de la API

Saldos

Cotizaciones

Payouts

Payins

Tarjetas

Webhooks

Payout actualizado

Campos de `data`

Estados del payout (`data.state`)

​Campos de data

​Estados del payout (data.state)

Campos de `data`

Estados del payout (`data.state`)