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.

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

{
  "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 · Entrega y firma Actualizar incorporacion — 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.

​Entrega y firma

​Eventos

​Carga útil

​Campos

​Procesar actualizaciones

​Véase también