Webhooks de onboarding de clientes

Receba atualizações de onboarding para saques, depósitos fiat e contas virtuais. Estes eventos representam casos de onboarding, não pagamentos nem liquidações.

Entrega e assinatura

Configure as URLs de webhook na chave API mestre da empresa para a rede do cliente, mainnet ou testnet. São usadas URLs ativas; sem elas, usa-se a URL única legada. São eventos empresariais e não exigem wallet. Verifique HMAC-SHA512 com essa chave mestre, não uma chave de wallet. O cabeçalho padrão é x-blockradar-signature; configurações personalizadas continuam válidas.

Eventos

Evento	Significado
`customer.onboarding.submitted`	Enviado ao provedor.
`customer.onboarding.in_review`	Em análise.
`customer.onboarding.action_required`	O cliente precisa agir. Consulte o caso e seus requisitos atuais.
`customer.onboarding.approved`	Aprovado; repita a operação com uma nova sessão.
`customer.onboarding.rejected`	Rejeitado.
`customer.onboarding.failed`	O processamento do onboarding falhou.
`customer.onboarding.expired`	O onboarding expirou.

Payload

{
  "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 do caso de onboarding; não é o ID do cliente nem da transação.
`data.customerId`	ID do cliente.
`data.provider`	ID, slug e nome do provedor.
`data.status`	Status atual do onboarding.
`data.previousStatus`	Status anterior ou null.
`data.reason`	Motivo ou null.
`data.availableActions`	Ações disponíveis: edit_and_resubmit e/ou refresh_provider_steps, ou lista vazia. Consulte o caso antes de agir.
`data.createdAt`	Data de criação do caso.
`data.updatedAt`	Data de atualização do caso, não de entrega.

Processar atualizações

Confirme rapidamente com HTTP 200 e processe de forma idempotente. Reenvios podem duplicar eventos; use o ID do caso, event e updatedAt para reconhecê-los e consulte o estado atual. Atualizações idênticas de status e motivo são suprimidas; action_required pode repetir quando ações ou sessões hospedadas mudarem. Nem todo status intermediário gera evento. A aprovação não movimenta fundos nem garante elegibilidade empresarial.

Veja também

Fluxos fiat para clientes · Entrega e assinatura Atualizar onboarding — Solicite novas taxas de saque ou uma nova cotação de depósito para criar outra sessão fiat. Não reutilize a sessão anterior à aprovação. Mudanças também podem emitir webhooks customer.onboarding.*; casos sem mudanças não garantem outro evento.

​Entrega e assinatura

​Eventos

​Payload

​Campos

​Processar atualizações

​Veja também