Intégration et API
Comment puis-je recevoir des mises à jour de vérification ?
Configurez les abonnements webhook appropriés, vérifiez les signatures et traitez en toute sécurité les tentatives et les changements de statut ultérieurs.
Équipe Toden · 2 min de lecture · Français
Sur cette page
Réponse courte
Créez un point de terminaison webhook dans le bon environnement et abonnez-vous aux événements dont votre intégration a besoin. Vérifiez la signature, stockez l'ID d'événement logique et gérez la mise à jour sur votre backend. L’écran de complétion du candidat ne remplace pas un résultat vérifié.
Abonnez-vous aux bons changements
L'achèvement de la vérification initiale et les changements de statut ultérieurs répondent à des objectifs différents. Abonnez-vous aux événements de résultats de vérification documentés et ajoutez des événements de statut mis à jour lorsque votre système nécessite des modifications de réviseur, de flux de travail ou de nouvelle soumission. Un point de terminaison plus ancien ne peut pas être abonné aux événements ajoutés après sa création.
Utilisez le catalogue d'événements et la documentation actuelle des familles d'événements pour connaître la charge utile exacte. Ne construisez pas de gestionnaire autour d'un champ inventé à partir d'un exemple pour un autre produit.
Traitez la livraison en toute sécurité
Vérifiez le schéma de signature actuel par rapport aux octets bruts de la requête avant de faire confiance à la charge utile. Conservez le secret de signature de chaque point de terminaison dans le magasin secret de votre serveur et utilisez l’environnement correspondant. L'analyse et la re-sérialisation du corps avant la vérification peuvent briser les signatures.
Conservez l’ID d’événement d’enveloppe pour dédoublonner les actions commerciales. Un renvoi manuel peut créer un autre enregistrement de diffusion pour le même événement logique. L’ordre de livraison entre les événements n’est pas garanti ; comparez la version de la ressource ou lisez l’état actuel là où la décision est importante.
Accusez réception rapidement des livraisons acceptées et effectuez un travail plus lent de manière asynchrone avec votre propre traitement durable. Ne reconnaissez pas un événement que vous ne pouvez pas conserver en toute sécurité pour traitement.
Testez avant de passer en ligne
Utilisez l'action de test du webhook de la console dans Sandbox, inspectez l'historique de livraison et renvoyez un événement. Confirmez que son effet commercial se produit une seule fois. Exercez les réponses échouées, les tentatives, une signature invalide et les modifications dans le désordre. Ensuite, configurez et testez le point de terminaison et le secret de production distincts.
Guides associés
Cet article vous a-t-il aidé ?