> ## 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 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.

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

```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 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](https://docs.blockradar.co/pt/guides/customer-fiat-flows.md) · [Entrega e assinatura](https://docs.blockradar.co/pt/utilities/webhooks.md)

[Atualizar onboarding](https://docs.blockradar.co/pt/api-reference/customer-onboarding/refresh-request.md) — 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.


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