​
Prerequisites

If you are already using OTPLESS SDK for authentication, then you don’t need to use AutoRead SDK because OTPLESS SDK auto reads the OTP itself. AutoRead SDK is to be used by merchants using OTPLESS APIs or some other vendor for authentication.

​
WhatsApp OTP AutoRead

  1. Get the OTP message template whitelisted by OTPLESS Support Team for OTPs that the users will receive on WhatsApp.
  2. Make sure the app hash that is whitelisted by OTPLESS matches your app hash at application runtime. If the app hash is different from the whitelisted app hash, WhatsApp OTP AutoRead won’t work. You can follow this guide to generate your app hash.

​
SMS OTP AutoRead

  1. Make sure that the SMS template contains your app hash. You can follow this guide to generate your app hash.

​
Dependency

Add the following dependency to your build.gradle file:

dependencies {
    implementation("io.github.otpless-tech:otpless-autoread-sdk:0.1.0")
}

​
Usage

To enable OTP AutoRead, use the following methods based on the type of OTP you want to auto-read:

​
SMS OTP AutoRead

Register for auto-reading OTPs from SMS by calling the registerSmsOtpReceiver method:

AutoReadSDK.getInstance()
    .registerSmsOtpReceiver(context) { otpAutoReadResult ->
        if (otpAutoReadResult.otp != null) {
            Log.d(TAG, otpAutoReadResult.otp)
            // Unregister register once SMS is received
            AutoReadSDK.getInstance().unregisterSmsOtpReceiver()
        } else {
            // Handle error
            val errorMessage = otpAutoReadResult.errorMessage
        }
    }

​
WhatsApp ZeroTap OTP AutoRead

  • WhatsApp ZeroTap OTP AutoRead works for devices with Android API level 24 (Nougat) and above. Register for auto-reading OTPs from WhatsApp by calling the registerWhatsAppZeroTap method:
AutoReadSDK.getInstance()
    .registerWhatsAppZeroTap(context) { otpAutoReadResult ->
        if (otpAutoReadResult.otp != null) {
            Log.d(TAG, otpAutoReadResult.otp)
        } else {
            // Handle error
            val errorMessage = otpAutoReadResult.errorMessage
        }
    }

​
WhatsApp OneTap OTP AutoRead

  • WhatsApp OneTap OTP AutoRead works for devices with Android API level 24 (Nougat) and above. Register for auto-reading OTPs from WhatsApp by calling the registerWhatsAppOneTap method:
AutoReadSDK.getInstance()
    .registerWhatsAppZeroTap(context) { otpAutoReadResult ->
        if (otpAutoReadResult.otp != null) {
            Log.d(TAG, otpAutoReadResult.otp)
        } else {
            // Handle error
            val errorMessage = otpAutoReadResult.errorMessage
        }
    }

Additionally, ensure your activity is set to singleTop launch mode and exported attribute is true:

android:launchMode="singleTop"
android:exported="true"

Override the onNewIntent function to receive intent from WhatsApp for OneTap OTP AutoRead.

 override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        if (AutoReadSDK.getInstance().onNewIntent(intent)) return
    }

If you are using both SMS and WhatsApp OTP AutoRead methods, then unregister the SMS OTP receiver as well if OTP is fetched via WhatsApp.

Was this page helpful?