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

# Webhooks de incorporacion de clientes

> Reciba actualizaciones de incorporación para retiros, depósitos fiat y cuentas virtuales. Estos eventos describen casos de incorporación, no pagos ni fondos liquidados.

Reciba actualizaciones de incorporación para retiros, depósitos fiat y cuentas virtuales. Estos eventos describen casos de incorporación, no pagos ni fondos liquidados.

## Entrega y firma

Configure las URL de webhook en la clave API maestra de la empresa para la red del cliente, mainnet o testnet. Se usan las URL activas; si no hay ninguna, se usa la URL única heredada. Son eventos empresariales y no requieren una wallet. Verifique HMAC-SHA512 con esa clave maestra, no con una clave de wallet. La cabecera predeterminada es x-blockradar-signature; se respetan las cabeceras personalizadas.

## Eventos

| Evento | Significado |
| - | - |
| `customer.onboarding.submitted` | Enviado al proveedor. |
| `customer.onboarding.in_review` | En revisión. |
| `customer.onboarding.action_required` | El cliente debe actuar. Consulte el caso y sus requisitos actuales. |
| `customer.onboarding.approved` | Aprobado; reintente la operación con una sesión nueva. |
| `customer.onboarding.rejected` | Rechazado. |
| `customer.onboarding.failed` | Falló el procesamiento de incorporación. |
| `customer.onboarding.expired` | La incorporación caducó. |

## Carga útil

```json theme={null}
{
  "event": "customer.onboarding.approved",
  "data": {
    "id": "8392013d-2481-47c9-b5e3-b61b22b8ff82",
    "customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
    "provider": {
      "id": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
      "slug": "noah",
      "name": "Noah"
    },
    "status": "approved",
    "previousStatus": "in_review",
    "reason": null,
    "availableActions": [],
    "createdAt": "2026-10-31T10:00:00.000Z",
    "updatedAt": "2026-10-31T10:15:00.000Z"
  }
}
```

## Campos

| Campo | Significado |
| - | - |
| `data.id` | ID del caso de incorporación; no es el ID del cliente ni de una transacción. |
| `data.customerId` | ID del cliente. |
| `data.provider` | ID, slug y nombre del proveedor. |
| `data.status` | Estado actual de incorporación. |
| `data.previousStatus` | Estado anterior o null. |
| `data.reason` | Motivo o null. |
| `data.availableActions` | Acciones disponibles: edit\_and\_resubmit y/o refresh\_provider\_steps, o una lista vacía. Consulte el caso antes de actuar. |
| `data.createdAt` | Fecha de creación del caso. |
| `data.updatedAt` | Fecha de actualización del caso, no de entrega. |

## Procesar actualizaciones

Confirme rápidamente con HTTP 200 y procese de forma idempotente. Puede haber reintentos duplicados; use el ID del caso, event y updatedAt para reconocerlos y consulte el estado actual. Se suprimen actualizaciones idénticas de estado y motivo; action\_required puede repetirse si cambian las acciones o sesiones alojadas. No todos los estados intermedios emiten eventos. La aprobación no mueve fondos ni garantiza la elegibilidad empresarial.

## Véase también

[Flujos fiat para clientes](https://docs.blockradar.co/es/guides/customer-fiat-flows.md) · [Entrega y firma](https://docs.blockradar.co/es/utilities/webhooks.md)

[Actualizar incorporacion](https://docs.blockradar.co/es/api-reference/customer-onboarding/refresh-request.md) — Solicite nuevas tasas de retiro o una nueva cotización de depósito para crear una sesión fiat nueva. No reutilice una sesión anterior a la aprobación. Los cambios también pueden emitir webhooks customer.onboarding.\*; un caso sin cambios no garantiza un evento nuevo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.