Verifying non Truecaller users

In order to verify non Truecaller users, the SDK requires the below mentioned permissions -

For Android 8 and above :
​
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.READ_CALL_LOG"/>
<uses-permission android:name="android.permission.ANSWER_PHONE_CALLS"/>
​
​
For Android 7 and below :
​
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.READ_CALL_LOG"/>
<uses-permission android:name="android.permission.CALL_PHONE"/>

@Override
public void onRequestPermissionsResult(final int requestCode, @NonNull final String[] permissions,
                                           @NonNull final int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}

Once you receive a callback in the ITrueCallback#onVerificationRequired(), you can initiate the verification for the user by calling the following method:

TruecallerSDK.getInstance().requestVerification("IN", PHONE_NUMBER_STRING, apiCallback, ExampleActivity.this);

Here -

• the first parameter is the country code of the mobile number for which the verification needs to be triggered

• the second parameter (PHONE_NUMBER_STRING) is the 10-digit mobile number

• the third parameter is an instance of VerificationCallback as defined here​

• the fourth parameter is an instance of FragmentActivity

Once you initiate the verification via TruecallerSDK.getInstance().requestVerification() method, you will receive either a callback in your VerificationCallback instance with a specificrequestType as described below

static final VerificationCallback apiCallback = new VerificationCallback() {
​
     @Override
     public void onRequestSuccess(int requestCode, @Nullable VerificationDataBundle extras) {
 	    
        if (requestCode == VerificationCallback.TYPE_MISSED_CALL_INITIATED) {
               if(extras != null) 
                      extras.getString(VerificationDataBundle.KEY_TTL)
 	      }
 
        if (requestCode == VerificationCallback.TYPE_MISSED_CALL_RECEIVED) {
 	      }
 
        if (requestCode == VerificationCallback.TYPE_OTP_INITIATED) {
               if(extras != null) 
                      extras.getString(VerificationDataBundle.KEY_TTL)
 	      }
 
        if (requestCode == VerificationCallback.TYPE_OTP_RECEIVED) {
 	      }
 
        if (requestCode == VerificationCallback.TYPE_VERIFICATION_COMPLETE) {
 	      }
 
        if (requestCode == VerificationCallback.TYPE_PROFILE_VERIFIED_BEFORE) {
 	      }
 
     }
​
     @Override
     public void onRequestFailure(final int requestCode, @NonNull final TrueException e) {
     }
     
 };

onRequestSuccess() method is called under any of the following scenarios -

• When drop call is successfully initiated for the input mobile number. In this case, you will get the requestCode as VerificationCallback.TYPE_MISSED_CALL_INITIATED

• When drop call is successfully detected on that device by the SDK present in your app. In this case, you will get the requestCode as VerificationCallback.TYPE_MISSED_CALL_RECEIVED

• When OTP is successfully triggered for the input mobile number. In this case, you will get the requestCode as VerificationCallback.TYPE_OTP_INITIATED

• When OTP is successfully detected on that device by the SDK present in your app. In this case, you will get the requestCode as VerificationCallback.TYPE_OTP_RECEIVED

• When the verification is successful for a particular number. In this case, you will get the requestCode as VerificationCallback.TYPE_VERIFICATION_COMPLETE

• When the user is already verified on that particular device before. In this case, you will get the requestCode as VerificationCallback.TYPE_PROFILE_VERIFIED_BEFORE

When requestCode is VerificationCallback.TYPE_MISSED_CALL_INITIATED or VerificationCallback.TYPE_OTP_INITIATED , you will receive an additional parameter for the time to live i.e TTL (in seconds) which is passed as String extra in the VerificationDataBundle of onRequestSuccess(). This value determines amount of time left to complete the verification. You can use this value to show a waiting message to your user before they can try for another attempt. Once the TTL expires, you can either auto-retry the verification by calling the requestVerification() method automatically with the same input parameters OR you can also take the user back to the number input screen to enter a different number for verification.

When the requestCode is VerificationCallback.TYPE_ALREADY_VERIFIED_BEFORE or VerificationCallback.TYPE_VERIFICATION_COMPLETE, it means that the user verification via Truecaller SDK is complete. In these cases, the SDK will share an additional access token with your application, which you may then use to validate the response at your server end. To fetch the access token, you may use the following code snippet :

//For when the control goes to TYPE_ALREADY_VERIFIED_BEFORE extras.getProfile().accessToken

//For when the control goes to TYPE_VERIFICATION_COMPLETE extras.getString(VerificationDataBundle.KEY_ACCESS_TOKEN)

Post fetching the access token, you may perform the server side validation by referring to the steps mentioned in the later part of the documentation here.

onRequestFailure() method will be called when some error has occurred while verifying the provided mobile number. You will receive the appropriate error message from TrueException using TrueException#getExceptionMessage().For details of different possible error types you may encounter, please refer to the next section​