Synaps
Search…
Webhooks
Webhooks are useful to sync Synaps state changes with your own database without calling our API every minutes or hours.
It will triggers your endpoint each time Synaps make a change to its verifications.
To create a new webhook, enter your webhook URL and click on Activate.
You will see a new input "Secret" which is the value Synaps sends in query params for each webhooks.

Webhook Checklist

    Use HTTPS secure webhook URL to enable secured communication
    For each request, verify that the secret query params is the one provided in your manager interface (T4zWYzNwHR...)
    Allow inbound requests from these 2 IPs 52.51.148.88 and 52.208.145.228 in your firewall

Webhook Deliveries

For each webhook that we send to your payload URL, we are saving the response output to help you debug in case of errors.

Webhook Request

You should create a POST request in your Private API that will take as JSON Content-Type and will receive the following object
SUBMITTED WEBHOOK
This webhook is sent each time a user has submitted a step.
1
{
2
"reason": "",
3
"service": "RESIDENCY",
4
"session_id": "2ac3f7ab-3729-f968-3f55-aa47e881",
5
"state": "SUBMITTED",
6
"step_id": "1253242"
7
}
Copied!
VALIDATED WEBHOOK
This webhook is sent each time a user has validated a step.
1
{
2
"reason": "",
3
"service": "RESIDENCY",
4
"session_id": "2ac3f7ab-3729-f968-3f55-aa47e881",
5
"state": "VALIDATED",
6
"step_id": "1253242"
7
}
Copied!
REJECTION WEBHOOK
This webhook is sent when a user has been rejected and requires a new submission
1
{
2
"reason": "Document type invalid",
3
"service": "IDENTITY",
4
"session_id": "71c8a5e9-1fa3-a595-f74a-ae85424c",
5
"state": "REJECTED",
6
"step_id": "8294827"
7
}
Copied!
FINAL REJECTION WEBHOOK
This webhook is sent when a user has been rejected for a reason that will not allows further resubmission.
1
{
2
"reason": "User attempts to submit a forged document",
3
"service": "IDENTITY",
4
"session_id": "2ac3f7ab-3729-f968-3f55-aa47e881",
5
"state": "FINAL_REJECTED",
6
"step_id": "3233223"
7
}
Copied!
We don't disclose any private information through the webhook. You should always make a call to the API in order to fetch user information.
We are sending a secret value as a query parameter in the POST request. This secret is unique to your app and is available in your manager. Double-check this value each time you receive a webhook to make sure that Synaps is the one who sends this request.
Last modified 2mo ago