Saltar al contenido principal
Tipo de evento: balance.updated Cubre tanto depósitos fiat (riel bancario) como depósitos cripto on-chain — se distinguen por el campo blockchain (bridge para fiat, o el nombre de la red como polygon, tron, stellar para cripto). Ver Resumen de webhooks para entrega, headers y verificación de firma.

​
Campos de data

​
payoutId
string
El identificador del depósito (se llama payoutId por consistencia de transporte).
​
companyId
string
El identificador de tu empresa.
​
externalId
string
Tu referencia externa, si se proporcionó.
​
previousState
null
Siempre null para eventos de depósito.
​
state
string
El estado actual del depósito.
​
amount
number
El monto del depósito, en unidades mínimas.
​
currency
string
La moneda del depósito (por ejemplo, usdc).
​
blockchain
string
bridge para depósitos fiat, o el nombre de la red (por ejemplo, polygon, tron, stellar) para depósitos cripto on-chain.
​
txHash
string | null
Hash de la transacción on-chain, cuando está disponible.
​
errorReason
string | null
Motivo de la falla, cuando aplica.
​
updatedAt
string
Marca de tiempo de última actualización (ISO 8601).
{
  "type": "balance.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": null,
    "state": "funds_received",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}