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

> Se envía cuando un depósito cripto on-chain cambia de estado.

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

<Note>
  `crypto_deposit.updated` es el sucesor, para depósitos on-chain, del evento `balance.updated` (deprecado). Durante la migración se entregan ambos nombres para el mismo depósito —`crypto_deposit.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 on-chain a `crypto_deposit.updated` antes de esa fecha.
</Note>

Depósitos cripto on-chain. Para depósitos fiat (riel bancario), ver [Depósito fiat actualizado](/es/api-reference/webhooks/payin-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="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 pasó el depósito. Un evento se emite solo cuando el estado cambia realmente, así que la transición siempre es significativa. Es `null` en el primer evento.</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">La red en la que se liquidó el depósito (por ejemplo, `polygon`, `tron`, `stellar`).</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 Primer evento theme={null}
  {
    "type": "crypto_deposit.updated",
    "timestamp": "2026-06-23T12:00:00.000Z",
    "data": {
      "eventId": "crypto-deposit:dep_9f86d081884c7d65:none:pending",
      "payoutId": "dep_9f86d081884c7d65",
      "companyId": "cmp_123",
      "externalId": "ext-009",
      "previousState": null,
      "state": "pending",
      "amount": 100000,
      "currency": "usdc",
      "blockchain": "polygon",
      "txHash": "0xdef456",
      "errorReason": null,
      "updatedAt": "2026-06-23T12:00:00.000Z"
    }
  }
  ```

  ```json Cambio de estado theme={null}
  {
    "type": "crypto_deposit.updated",
    "timestamp": "2026-06-23T12:05:00.000Z",
    "data": {
      "eventId": "crypto-deposit:dep_9f86d081884c7d65:confirmed:completed",
      "payoutId": "dep_9f86d081884c7d65",
      "companyId": "cmp_123",
      "externalId": "ext-009",
      "previousState": "confirmed",
      "state": "completed",
      "amount": 100000,
      "currency": "usdc",
      "blockchain": "polygon",
      "txHash": "0xdef456",
      "errorReason": null,
      "updatedAt": "2026-06-23T12:05:00.000Z"
    }
  }
  ```
</ResponseExample>