Saltar al contenido principal
Tipo de evento: payout.update El type del evento es siempre payout.update, 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

​
payoutId
string
El identificador del payout.
​
companyId
string
El identificador de tu empresa.
​
externalId
string
Tu referencia externa, si se proporcionó.
​
onBehalfOf
string
El usuario/entidad para quien se hizo el payout.
​
previousState
string | null
El estado previo a esta transición. Es null en el primer evento.
​
state
string
El estado actual del payout. Ver la tabla de abajo.
​
amount
number
El monto del payout, en unidades mínimas (por ejemplo, centavos).
​
currency
string
La moneda de destino.
​
destinationType
string
Uno de wallet, bank o qr_code.
​
errorReason
string
Presente solo cuando el payout falló.
​
txHash
string
Hash de la transacción on-chain. Presente para destinos wallet y bank.
​
extraData
object
Metadatos del riel bancario. Presente solo para destinationType = bank.
​
createdAt
string
Marca de tiempo de creación (ISO 8601).
​
updatedAt
string
Marca de tiempo de última actualización (ISO 8601).

​
Estados del payout (data.state)

EstadoSignificado
createdPayout creado
in_reviewEn revisión (pre-partner)
awaiting_fundsEsperando fondos
funds_receivedFondos recibidos
payment_submittedEnviado / en proceso
payment_processedCompletado exitosamente
undeliverableNo entregable
returnedDevuelto
refundedReembolsado
canceledCancelado
errorError / fallido
{
  "type": "payout.update",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "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"
  }
}