Callback URL (WebHook)

Configure a Callback URL

You can configure a callback URL for your application through Routee web interface
Visit https://dev.routee.net

Create a new application

Then Create a new Application giving a name and a description

Select Services

Select "Two Step Service" from the Services dropdown

👍

Additional Services

You can select more than one services for your application.

Application Settings

At this point you can set up different settings for your application
Parameters that can be set are:

• lifetime
• code digits
• max retries
• callback url

Callback Payload

Routee will POST the following json object every time the status of a verification changes.

{
    "applicationId": "string",
    "trackingId": "string",
    "recipient": "string",
    "status": "string",
    "updatedAt": "date"
    }

👍

Retry Policy

When Routee POSTs back to your service, an HTTP 200 OK response must be returned within 2 seconds. If Routee doesn't receive a 200 OK response within 2 seconds will drop the connection and will try to POST again (up 12 retries for 24 hours max) with the following retry policy after the initial callback attempt:

1st retry: 30 sec
2nd retry: 1 minute
3rd retry: 2 minutes
4th retry: 5 minutes
5th retry: 10 minutes
6th retry: 15 minutes
7th retry: 30 minutes
8th retry: 1 hour
9th retry: 2 hours
10th retry: 4 hours
11th retry: 8 hours
12th retry: 24 hours

🚧

Whitelist IP for callback service

Whitelist all the IPs that resolve to the following domain:
your callback URL secret token
in order to be able to receive callback requests from Routee