https://manuals.fivaldi.net/customer/webhook/index.html#/Webhooks/post_webhooks
1. Subscribing to EventType(s) starts by creating a webhook with POST Webhook API. Following info is required in the request body:
{
"verifyToken": "Integer - used to verify the partner’s uri",
"uri": "String - URI where the partner will receive event notifications",
"eventTypes": "Array of Strings - which EventTypes the webhook will subscribe to"
}
2. Fivaldi will check that the partner has no existing Webhooks already using the given URI. If a webhook exists, the following error is returned:
HTTP 400
"webhook.partnerid_uri_exist",
"Webhook exists already for partner and given uri"
3. Fivaldi will verify the given URI by sending a GET request to it, using the verifyToken and a random number as request parameters. Partner’s uri should respond by using status HTTP 200 and the received random number in the response body. In case the numbers don’t match, the following error is returned:
HTTP 400
"webhook.uri_challenge_check",
"Webhook challenge check failed when verifying partner uri."
4. Fivaldi will generate a secret for the Webhook and store it.
5. The following response will be returned on a successful Webhook creation:
Status: HTTP 200
Body:
{
"status": "OK",
"httpResponseCode": "OK",
"fetchedAt": Unix timestamp,,
"result": {
"webhookId": ID in Fivaldi
"secretBase64": Secret which Fivaldi will use to sign requests, for partner to use in Hash verification
},
"errors": []
}
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback