Skip to main content
Tipo de evento: balance.updated
balance.updated está deprecado y se dividió en dos eventos específicos. Se sigue entregando durante la migración, pero se eliminará el 15 de noviembre de 2026. Migra a:El payload es idéntico (más un data.eventId para deduplicación).
Cubre tanto depósitos fiat (riel bancario) como depósitos cripto on-chain — se distinguen por el nombre del evento de arriba, o por el nombre de la red en el campo blockchain (por ejemplo, polygon, tron, stellar) para cripto. Ver Resumen de webhooks para entrega, headers y verificación de firma.
Los campos de abajo describen los depósitos por riel bancario y on-chain. Los depósitos hechos mediante un código de pago (PIX en Brasil, QR en Bolivia) también se entregan bajo este nombre heredado, pero llevan otro conjunto de campos: sin payoutId, blockchain ni txHash, y con id, method y creditedUsdc, además de un previousState que no siempre es null. Ver Depósito fiat actualizado para ese payload.

​
Campos de data

​
string
El identificador del depósito (se llama payoutId por consistencia de transporte).
​
string
El identificador de tu empresa.
​
string
Tu referencia externa, si se proporcionó.
​
string | null
El estado desde el que se movió el depósito. Siempre null en depósitos por riel bancario y on-chain: un mismo depósito genera varios eventos a medida que avanza, pero cada uno se reporta por separado, así que guíate por state y no por la transición.
​
string
El estado actual del depósito.
​
number
El monto del depósito, en unidades mínimas.
​
string
La moneda del depósito (por ejemplo, usdc).
​
string
El riel de liquidación para depósitos fiat, o el nombre de la red (por ejemplo, polygon, tron, stellar) para depósitos cripto on-chain.
​
string | null
Hash de la transacción on-chain, cuando está disponible.
​
string | null
Motivo de la falla, cuando aplica.
​
string
Marca de tiempo de última actualización (ISO 8601).