Contexte
Afin de sécuriser les échanges de données confidentielles, ProAbono impose une étape de validation des Webhooks pour entériner sa mise en service.
Pour cela, ProAbono va simplement vérifier que l’URL de destination est bien une URL que vous contrôlez grâce à l’envoi d’un code de vérification unique.
Si vous voulez en savoir plus sur les Webhooks.
Attention ! Un webhook ne sera fonctionnel qu’une fois cette étape de validation réalisée avec succès.
Prérequis
- Avoir créé un webhook
Procédure
1) Sélectionnez le Webhook à valider
- Cliquez sur « Intégration » depuis le menu principal.
- Puis cliquez sur “configuration des Webhooks“
- Puis cliquez sur la ligne correspondante au Webhook souhaité.
2) Accédez au processus de validation
- cliquez sur l’état “À valider“.
3) Lancez la vérification
Cliquer sur le bouton “Envoyer le code de vérification” .
Cela déclenchera l’envoi d’une requête POST avec un code de vérification au format JSON à l’URL de notification définie.
4) Renseignez votre code de vérification
Renseignez le code de vérification reçu (dans le body de la requête) pour entériner l’activation de votre Webhook.
Si tout s’est bien passé, vous pourrez voir le Status passer à l’état « Actif ». Dans ce cas, bravo votre Webhook est désormais bien valide et opérationnel.
Attention ! Après la requête envoyée, ProAbono s’attend à recevoir en réponse un statut HTTP 200. Si ce n’est pas le cas, ProAbono ne considère pas l’échange comme valide et vous ne pourrez pas saisir le code de confirmation.