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.
CountryPrimary methodSecondary method
United StatesSilent VerifyWhatsapp
BrazilSMSEmail
FrancePush Verify

Default fallback times

This feature uses the following default fallback times:

Fallback timeVerification methods
60 secondsSilent Verify, Push Verify, SMS, Whatsapp, Viber, RCS
120 secondsEmail

For adjustments to the default fallback times, contact our Customer Support Team.