Verify API - Fixed routing by country
NOTE:
To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.
The fixed routing feature allows you to manage verification methods for each country, providing enhanced control and flexibility. Fixed routing simplifies the fallback process by allowing you to set up specific routing preferences by contacting our support team.
NOTE:
To set up this feature for your account, contact our Customer Support Team.
This feature enables you to leave out a verification_policy
parameter in the request. If you include a verification_policy
in the request, it will override the fixed routing settings for that particular request.
The end user’s phone number must be included in the request if you want to use fixed routing. We use the phone number prefix to determine the country (e.g. +1 for the United States). Without the phone number, we can’t determine the country code and thus, we can’t determine which verification methods were selected for a specific end user’s country.
You can specify up to two verification methods for each country. SMS will automatically be used as the third fallback method. If you prefer not to use SMS, contact our Customer Support Team.
Example
In the provided example, depending on the end user's country, the verification processes are handled as follows:
- United States: Verification starts with Silent Verify. If Silent Verify fails, it tries with WhatsApp. If both methods fail, SMS is used as the default final verification method.
- Brazil: Verification starts with SMS, then email. No further attempts if email fails since SMS was already the first method.
- France: Verification starts with Push Verify and then SMS if needed.
Country | Primary method | Secondary method |
---|---|---|
United States | Silent Verify | |
Brazil | SMS | |
France | Push Verify |
Default fallback times
This feature uses the following default fallback times:
Fallback time | Verification methods |
---|---|
60 seconds | Silent Verify, Push Verify, SMS, Whatsapp, Viber, RCS |
120 seconds |
For adjustments to the default fallback times, contact our Customer Support Team.
Updated 2 months ago