OTP-Assist

Steps to enable OTP auto-read and auto-submit on your Android app for payments that rely on OTP for completion.


With Razorpay OTP-Assist, your customers gain a faster and enhanced checkout experience with Razorpay OTP auto-read and auto-submit. The system automatically reads the OTP your customers receive, and with the customer's consent, auto-fills and auto-submits the OTP. It prevents errors and the users do not need to navigate or interact with additional elements to complete verification, making the process seamless.

  • Create a

    .

  • Generate the

    from the Razorpay Dashboard. To go live with the integration and start accepting real payments, generate Live Mode API Keys and replace them in the integration.

  • Integrate with

    .

Add the following line in your build.gradle(app-level) file in the dependencies block:

dependencies{
//other dependencies
implementation "com.razorpay:otp-assist:1.0.0""
//other dependencies
}

1.

.

2.

.

3

.

You can use one of the options below based on your requirement:

The startSmsListener function starts SmsRetrieverClient and attaches BroadcastReceivers, which notifies about the incoming SMS messages. Once the message is received and parsed, the OTP is auto-filled and subsequently auto-submitted on the page loaded in WebView.

void startSmsListener(WebView webView)

WebView

object The object created by you and passed to Razorpay Custom Checkout SDK within which the ACS page loads.

Use the sample code given below:

Razorpay razorpay = new Razorpay(PaymentActivity.this);
// RazorpayOtpAssist is initialized by Custom Checkout's Razorpay object internally
// You need the UI Activity object here as RazorpayOtpAssist attaches a new fragment to display the timer
// Other code
razorpay.otpAssist.startSmsListener(webview);
razorpay.submit(cardsPayload, new PaymentResultWithDataListener() {
@Override
public void onPaymentSuccess(String razorpayPaymentID, PaymentData paymentData) {}
@Override
public void onPaymentError(int code, String response, PaymentData paymentData) {}
});
// Other code

Razorpay offers Native OTP solutions where you can submit the OTP by calling the API provided by the Razorpay Custom Checkout SDK. To enable OTP auto-read and auto-submit of payments with this feature, we use a separate function that uses an interface to send the callback to you once the OTP is received.

public interface OtpListener {
void onOtpReceived(String sender, String body, String otp);
void onOtpConfirmed(String sender, String body, String otp);
}

OtpListener

object Acts as a callback, triggered when the OTP is received and parsed after the timer is displayed.

onOtpReceived

Triggered when the message is received and the SDK extracts OTP. Values:

  • sender: Sender of the message (default: razorpay).
  • body: The entire message.
  • OTP: OTP pin extracted from the message.

onOtpConfirmed

Triggered when the timer for OTP Auto-submit is allowed/confirmed by the user. Values:

  • sender: Sender of the message (default: razorpay).
  • body: The entire message.
  • OTP: OTP pin extracted from the message.

Use the sample code given below:

Razorpay razorpay = new Razorpay(PaymentActivity.this);
// Other code
razorpay.getCardsFlow(cardsPayload, new CardsFlowCallback() {
@Override
public void isNativeOtpEnabled(boolean isNativeOtpEnabled) {
if (isNativeOtpEnabled) {
razorpay.getCardOtpData(this);
}
}
@Override
public void otpGenerateResponse(boolean otpGenerated) {
if (otpGenerated) {
razorpay.otpAssist.startSmsListener(new OtpListener() {
@Override
public void onOtpReceived(@NonNull String sender, @NonNull String body, @NonNull String otp) {
// Fill {otp} in the input field
}
@Override
public void onOtpConfirmed(String sender, String body, String otp) {
razorpay.otpSubmit(otp, this);
}
});
}
}
@Override
public void otpResendResponse(boolean otpResent) {}
@Override
public void onOtpSubmitError(boolean otpSubmitError) {}
});
// Other code

When the application does not use the RECEIVE_SMS permission, we use the SmsRetreiverClient API provided by Google, which enables the user to give a one-time consent for the application to read the incoming message.

The user’s response for the one-time consent is passed to the activity’s onActivityResult function. Since the SDK cannot override this, we request you send this data to us.

void onActivityResult(String requestCode, String resultCode, Intent data)

requestCode

string Passed by RazorpayOtpAssist SDK when the startActivityForResult is triggered.

resultCode

string Contains user-selected action.

data

intent Contains data from the user-selected action.

Use the sample code given below:

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
razorpay.onActivityResult(requestCode, resultCode, data);
}

You can use this function to destroy all objects used by the RazorpayOtpAssist SDK to avoid leaks or when starting a new transaction with the same Razorpay object.

void reset()

Use the code given below:

//other code
razorpay.otpAssist.reset()
//other code

Handy Tips

We recommend using the existing Razorpay object for the following reasons:

  • You need not manage creating and deleting the RazorpayOtpAssist object. The Custom Checkout SDK handles this for you.
  • The Custom Checkout SDK becomes a singular entry point to use all Razorpay-powered features. This simplifies your integration process and improves the checkout experience for your customers.

Is this integration guide useful?