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.

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

{
  "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 · Livraison et signature Actualiser l’integration — 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.

​Livraison et signature

​Événements

​Charge utile

​Champs

​Traiter les mises à jour

​Voir aussi