Context
To secure the exchange of confidential data, ProAbono requires a validation step for Webhooks to confirm their activation.
For this, ProAbono will simply verify that the destination URL is indeed a URL that you control by sending a unique verification code.
If you want to learn more about Webhooks.
Attention! A webhook will only be functional once this validation step is successfully completed.
Prerequisites
- Have created a webhook
Procedure
1) Select the webhook to validate
- Click on “Integration” from the main menu.
- Then click on “Webhooks configuration“
- Then click on the line corresponding to the desired webhook.
2) Access the validation process
- Click on the “To be validated” status.
3) Initiate the verification
Click on the “Send verification code” button.
This will trigger a POST request with a verification code in JSON format to the defined notification URL.
4) Enter your verification code
Enter the received verification code (in the request body) to confirm the activation of your webhook.
If everything went well, you will see the Status change to “Active”. Congratulations, your webhook is now valid and operational.
Attention! Following the sent request, ProAbono expects to receive an HTTP status 200 in response. If this is not the case, ProAbono does not consider the exchange as valid and you will not be able to enter the confirmation code.