payin.updated
payin.updated es el sucesor, para depósitos fiat, del evento balance.updated (deprecado). Durante la migración se entregan ambos nombres para el mismo depósito —payin.updated (nuevo) y balance.updated (heredado)—, así puedes migrar sin perder eventos. balance.updated está deprecado y se eliminará el 15 de noviembre de 2026; apunta el manejo de depósitos fiat a payin.updated antes de esa fecha.payin.updated, pero los campos de data difieren entre los dos: cada campo indica abajo cuándo está presente. Para depósitos cripto on-chain, ver Depósito cripto actualizado. Ver Resumen de webhooks para entrega, headers y verificación de firma.
Campos de data
string
Identificador estable de este evento de depósito. El mismo valor se envía en el
balance.updated heredado durante la transición — úsalo para deduplicar los dos nombres.string
El identificador del depósito.
string
Alias deprecado de
id, con el mismo valor. Se envía solo en depósitos por riel bancario, y solo durante la transición.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. En depósitos por código de pago trae el estado anterior, y es
null solo en el primer evento. En depósitos por riel bancario siempre es null: 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 de
amount. En depósitos por código de pago es la moneda local en la que pagó el cliente (BOB, BRL); los USDC que recibes se reportan aparte, en creditedUsdc.string
El riel de pago:
pix o bo_qr_code. Solo en depósitos por código de pago.number | null
El monto en USDC acreditado a tu saldo una vez que el depósito se liquida;
null antes de eso. Solo en depósitos por código de pago.string
El riel de liquidación. Solo en depósitos por riel bancario.
string | null
No se establece para depósitos fiat. Solo en depósitos por riel bancario.
string | null
Motivo de la falla, cuando aplica.
string
Marca de tiempo de la actualización (ISO 8601).