> ## 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 fiat actualizado

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

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

<Note>
  `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.
</Note>

Depósitos fiat, liquidados por un **riel bancario** (una transferencia a una cuenta virtual) o mediante un **código de pago** (PIX en Brasil, QR en Bolivia). Ambos llegan como `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](/es/api-reference/webhooks/crypto-deposit-updated). Ver [Resumen de webhooks](/es/api-reference/webhooks/overview) para entrega, headers y verificación de firma.

### Campos de `data`

<ResponseField name="eventId" type="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.</ResponseField>
<ResponseField name="id" type="string">El identificador del depósito.</ResponseField>
<ResponseField name="payoutId" type="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.</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. 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.</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 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`.</ResponseField>
<ResponseField name="method" type="string">El riel de pago: `pix` o `bo_qr_code`. **Solo en depósitos por código de pago.**</ResponseField>
<ResponseField name="creditedUsdc" type="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.**</ResponseField>
<ResponseField name="blockchain" type="string">El riel de liquidación. **Solo en depósitos por riel bancario.**</ResponseField>
<ResponseField name="txHash" type="string | null">No se establece para depósitos fiat. **Solo en depósitos por riel bancario.**</ResponseField>
<ResponseField name="errorReason" type="string | null">Motivo de la falla, cuando aplica.</ResponseField>
<ResponseField name="updatedAt" type="string">Marca de tiempo de la actualización (ISO 8601).</ResponseField>

<ResponseExample>
  ```json Riel bancario theme={null}
  {
    "type": "payin.updated",
    "timestamp": "2026-06-23T12:00:00.000Z",
    "data": {
      "eventId": "payin:ext-009:funds_received",
      "id": "dep_9f86d081884c7d65",
      "payoutId": "dep_9f86d081884c7d65",
      "companyId": "cmp_123",
      "externalId": "ext-009",
      "previousState": null,
      "state": "funds_received",
      "amount": 100000,
      "currency": "usdc",
      "blockchain": "ach",
      "txHash": null,
      "errorReason": null,
      "updatedAt": "2026-06-23T12:00:00.000Z"
    }
  }
  ```

  ```json Código de pago (PIX / QR) theme={null}
  {
    "type": "payin.updated",
    "timestamp": "2026-07-27T17:08:00.000Z",
    "data": {
      "eventId": "payin:payin_889af3c5-96cf-4c38-a4b7-ede7438528d2:payment_processed",
      "id": "payin_889af3c5-96cf-4c38-a4b7-ede7438528d2",
      "companyId": "cmp_123",
      "externalId": "ext-042",
      "previousState": "awaiting_funds",
      "state": "payment_processed",
      "amount": 10000,
      "currency": "BOB",
      "creditedUsdc": 14.32,
      "method": "bo_qr_code",
      "errorReason": null,
      "updatedAt": "2026-07-27T17:08:00.000Z"
    }
  }
  ```
</ResponseExample>