Skip to main content
Version: 1.0

1.1 Verification Flow

Verification Flow​

The verification flow is designed to ensure that the user's phone number is verified. It involves several phases:

  • Initialization
  • Start Verification
  • Verification Result

Initialization​

When ever you need to verify your user's phone number, you have to call the initialize endpoint of the VerifySpeed API. The endpoint returns a list of available verification methods. Then, your backend returns this list to your mobile/web application, where the user selects the preferred verification method (e.g., WhatsApp Message or SMS OTP).

Start Verification​

When the user selcets a verification method, your app tells your backend to start the verification process with the selected verification method. Your backend sends a request to the VerifySpeed API's start endpoint, specifying the selected method (e.g., selected whatsapp-message for WhatsApp Message).

After the user completes the verification process, the verification token is returned to your mobile/web application.

Verification Result​

Once the verification process is completed by the user (either through deep link or scaning QR code), the SDK returns a verification token to your mobile/web application. This token is used in future requests that require the user's verified phone number (e.g., sign-up, login, or phone number change).

Upon receiving any request that needs verified user's phone number, your backend should use the verification token to retrieve the verification result by calling the result endpoint, which includes details about the verified phone number.

Typical Verification Flow​

The following is a typical verification flow (e.g. WhatsApp Message):

Locale Dropdown