Twilio Verification SDK for Android - SDK Reference

The Twilio Verification SDK for Android is downloadable via jCenter and has the following technical characteristics:

To initialize a phone verification process, call startVerification():

public void startVerification(String jwtToken, Via via);

If you decide to use the Via.SMS, then the SDK will automatically inspect the SMS inbox in the device and continue the process without interrupting the user.

Otherwise, as a fallback you can use Via.CALL This method will trigger a telephone call from Twilio and deliver a code to the user by voice. The language will be inferred by the API unless locale parameter was used in the JWT payload.

The user will need to manually input that code into your app and then your app will need to call checkVerificationPin() to complete the process

public void checkVerificationPin(String pin);

When the BroadcastReceiver receives an intent, the verification status can be extracted with getVerificationStatus. The result will be a VerificationStatus object.

The VerificationStatus object is a response holder that contains three methods:

public State getState();

Returns a State enum that can take as value: [ STARTED | AWAITING_VERIFICATION | SUCCESS | ERROR ]

• STARTED: The start verification was called, but the SMS has not arrived yet.
• AWAITING_VERIFICATION: The SMS arrived and we're waiting for the check call
• SUCCESS: The pin was verified. The verification token is available in the VerificationStatus object through the getVerificationToken() method.
• ERROR: There was an error while verifying. The exception can be recovered through the getVerificationException()

public String getVerificationToken();

The verification token has the following structure:

1
{
2
    valid: <true|false>,
3
    iat: <timestamp>,
4
    exp: <timestamp>,
5
    verification: {
6
        uuid: <PV-uuid>,
7
        via: <sms|call>,
8
        phone_number:  <phonenumber>,
9
        code_length: <4-10>
10
  }
11
}

Returns the verification token, which is proof that the verification was successful. The backend can decrypt this token later with the AUTHY_API_KEY to verify this.

public VerificationException getVerificationException();

This property will hold the verification exception if it did not succeed.