> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Depósito actualizado

> Se envía cuando un depósito (fiat o cripto) cambia de estado.

**Tipo de evento:** `balance.updated`

<Warning>
  `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:

  * [`payin.updated`](/es/api-reference/webhooks/payin-updated) — depósitos fiat (riel bancario).
  * [`crypto_deposit.updated`](/es/api-reference/webhooks/crypto-deposit-updated) — depósitos cripto on-chain.

  El payload es idéntico (más un `data.eventId` para deduplicación).
</Warning>

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](/es/api-reference/webhooks/overview) para entrega, headers y verificación de firma.

<Note>
  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](/es/api-reference/webhooks/payin-updated) para ese payload.
</Note>

### Campos de `data`

<ResponseField name="payoutId" type="string">El identificador del depósito (se llama `payoutId` por consistencia de transporte).</ResponseField>
<ResponseField name="companyId" type="string">El identificador de tu empresa.</ResponseField>
<ResponseField name="externalId" type="string">Tu referencia externa, si se proporcionó.</ResponseField>
<ResponseField name="previousState" type="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.</ResponseField>
<ResponseField name="state" type="string">El estado actual del depósito.</ResponseField>
<ResponseField name="amount" type="number">El monto del depósito, en unidades mínimas.</ResponseField>
<ResponseField name="currency" type="string">La moneda del depósito (por ejemplo, `usdc`).</ResponseField>
<ResponseField name="blockchain" type="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.</ResponseField>
<ResponseField name="txHash" type="string | null">Hash de la transacción on-chain, cuando está disponible.</ResponseField>
<ResponseField name="errorReason" type="string | null">Motivo de la falla, cuando aplica.</ResponseField>
<ResponseField name="updatedAt" type="string">Marca de tiempo de última actualización (ISO 8601).</ResponseField>

<ResponseExample>
  ```json balance.updated theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>