> ## 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 d’integration des clients

> Recevez les mises à jour d’intégration pour les retraits, dépôts fiat et comptes virtuels. Ces événements concernent les dossiers d’intégration, pas les paiements ni les fonds réglés.

Recevez les mises à jour d’intégration pour les retraits, dépôts fiat et comptes virtuels. Ces événements concernent les dossiers d’intégration, pas les paiements ni les fonds réglés.

## Livraison et signature

Configurez les URL de webhook sur la clé API principale de l’entreprise pour le réseau du client, mainnet ou testnet. Les URL actives sont utilisées ; sinon, l’ancienne URL unique est utilisée. Ces événements ne nécessitent pas de wallet. Vérifiez HMAC-SHA512 avec cette clé principale, pas une clé de wallet. L’en-tête par défaut est x-blockradar-signature ; les en-têtes personnalisés restent applicables.

## Événements

| Événement | Signification |
| - | - |
| `customer.onboarding.submitted` | Soumis au fournisseur. |
| `customer.onboarding.in_review` | En cours d’examen. |
| `customer.onboarding.action_required` | Une action du client est requise. Consultez le dossier et ses exigences actuelles. |
| `customer.onboarding.approved` | Approuvé ; réessayez avec une nouvelle session. |
| `customer.onboarding.rejected` | Rejeté. |
| `customer.onboarding.failed` | Le traitement de l’intégration a échoué. |
| `customer.onboarding.expired` | L’intégration a expiré. |

## Charge utile

```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"
  }
}
```

## Champs

| Champ | Signification |
| - | - |
| `data.id` | ID du dossier d’intégration, pas du client ni d’une transaction. |
| `data.customerId` | ID du client. |
| `data.provider` | ID, slug et nom du fournisseur. |
| `data.status` | Statut actuel du dossier. |
| `data.previousStatus` | Statut précédent ou null. |
| `data.reason` | Motif ou null. |
| `data.availableActions` | Actions disponibles : edit\_and\_resubmit et/ou refresh\_provider\_steps, ou liste vide. Consultez le dossier avant toute action. |
| `data.createdAt` | Date de création du dossier. |
| `data.updatedAt` | Date de mise à jour du dossier, pas de livraison. |

## Traiter les mises à jour

Répondez rapidement avec HTTP 200 et traitez les événements de façon idempotente. Des doublons sont possibles ; utilisez l’ID du dossier, event et updatedAt pour les reconnaître et consultez l’état actuel. Les mises à jour identiques du statut et du motif sont supprimées ; action\_required peut être répété si les actions ou sessions hébergées changent. Tous les statuts intermédiaires ne produisent pas d’événement. L’approbation ne déplace pas de fonds et ne garantit pas l’éligibilité de l’entreprise.

## Voir aussi

[Flux fiat pour les clients](https://docs.blockradar.co/fr/guides/customer-fiat-flows.md) · [Livraison et signature](https://docs.blockradar.co/fr/utilities/webhooks.md)

[Actualiser l’integration](https://docs.blockradar.co/fr/api-reference/customer-onboarding/refresh-request.md) — Demandez de nouveaux taux de retrait ou une nouvelle cotation de dépôt pour créer une nouvelle session fiat. Ne réutilisez pas une session antérieure à l’approbation. Les changements peuvent émettre des webhooks customer.onboarding.\* ; un dossier inchangé ne garantit pas un nouvel événement.


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