Phone verification

This section describes the phone number verification service. Looking for a way to verify user phone numbers? Tired of the traditional OTP verification and its accompanying issues? Look no further. First, create a verification see here (opens in a new tab), and let the user complete the further actions depending on the verification type selected.

Verification Types

We have two (2) types of verification which you can select from while creating a verification request.

1. SEND_SMS: This is not the regular SMS OTP verification you may be familiar with. Instead of sending an SMS to the phone number and requiring them to provide the code, we provide the code and a paired number to the user, and require them to send an SMS containing the code to the paired number from their phone number.

2. DROPPED_CALL: We provision a phone number to the user, and ask them to place a call to it. If we receive a call from the requesting phone number within the validity period, we will mark the verification as successful.

Verification Status

Every verification request will have one of the following statuses. Status will change based on the progress of the verification. You may provide an optional webhook to be notified when the status of a verification changes, or fetch the verification to check its status.

1. PENDING: Verification request has been created, and is waiting for further action.
2. EXPIRED: Verification has passed its expiry time while still pending.
3. FAILED: Wrong code was sent via SMS (for SMS type) or wrong phone number (for RECEIVED_CALL type)
4. SUCCESS: Verification was successful. User completed all further actions successfully.