UPI Intent - Razorpay

Available in🇮🇳 India

You can make UPI payments easier for your customers by enabling UPI Intent on your application Checkout.

Benefits

Enjoy the benefits such as higher conversion rates, decrease in abandoned carts and a decrease in time to complete the payment. Your customers are also benefited in the following ways:

No need to handle push or SMS notifications.
No need to switch between applications to complete a payment (merchant, SMS and app).
No need to remember their VPAs.

Understand Intent flow

The payment flow for UPI Intent payments is given below.

In the UPI Intent flow, the customer selects UPI as the payment method on your website or app. A list of UPI apps supporting the intent flow is displayed.

Watch Out!By default, the top PSP (Payment Service Provider) apps appear on the customer’s mobile irrespective of the installation status of the UPI apps.

The customers select their preferred app. The UPI app opens with pre-populated payment details.
The customers enter their UPI PIN to complete their transactions.
After the payment is successful, the customers are redirected to your app or website.

Supported Platforms

UPI Intent is supported on mWeb (Android and iOS) and Mobile App (WebView). On Desktop Web, UPI Intent is not supported, a QR code is automatically displayed instead.

Platform	Procedure
mWeb	Customers are redirected to their preferred UPI app to complete the payment. For the complete integration guide, refer to UPI Intent on Mobile Web.
Mobile App (WebView)	UPI Intent requires deep link handling in your Android or iOS app to launch UPI apps from the WebView. For the complete integration guide, refer to UPI Intent in WebView: Android and UPI Intent in WebView: iOS.
Desktop Web	UPI Intent is not supported. A QR code is automatically displayed for customers to scan with their preferred UPI app. No additional code changes are required.

Integrate on Android, iOS and Mobile Web

Android
iOS
Mobile Web

Use the Android SDK to support UPI Intent payments when a payment is processed through Razorpay in a WebView inside an app. UPI Checkout with Intent Flow

Installation

Download the JAR file and include it in the libs folder.

Initialisation

To initiate the SDK, call the Razorpay class constructor in your project and pass key as Razorpay API key and webView as the object that handles the payment flow.

import com.razorpay.Razorpay

Razorpay razorpay = new Razorpay(key, webView, activity);

import com.razorpay.Razorpay;

val razorpay = Razorpay(key, webview, activity)

Passing Result to Razorpay

After UPI is selected as the payment method, Razorpay invokes the Intent Flow page that lists all the available intent flows for the user to select and make the payment. Upon payment completion, the UPI app returns the result back to your activity in onActivityResult method. This should be passed to Razorpay as shown below:

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

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == Razorpay.UPI_INTENT_REQUEST_CODE) {
        razorpay.onActivityResult(requestCode, resultCode, data)
    }
}

Refer to the list of supported UPI intent apps for Android SDK.

Use the iOS Standard SDK to support UPI Intent payments on your iOS apps. Payment Process on iOS Apps

Prerequisites

Sign up for a Razorpay account.
Generate API Keys from the Dashboard.

iOS Standard Checkout

To enable UPI Intent on your iOS app’s Standard Checkout:

Ensure that the latest version of the iOS Standard SDK is integrated with your app.
Your iOS app must seek permission from the device to open the UPI PSP app that the customer selects on Checkout. For this, you must make the following changes in your iOS app’s info.plist file.

info.plist

 <key>LSApplicationQueriesSchemes</key>
 <array>
     <string>tez</string>
     <string>phonepe</string>
     <string>paytmmp</string>
     <string>credpay</string>
     <string>mobikwik</string>
     <string>in.fampay.app</string>
     <string>bhim</string>
     <string>amazonpay</string>
     <string>navi</string>
     <string>kiwi</string>
     <string>payzapp</string>
     <string>jupiter</string>
     <string>omnicard</string>
     <string>icici</string>
     <string>popclubapp</string>
     <string>sbiyono</string>
     <string>myjio</string>
     <string>slice-upi</string>
     <string>bobupi</string>
     <string>shriramone</string>
     <string>indusmobile</string>
     <string>whatsapp</string>
     <string>kotakbank</string>
 </array>
 <!-- List of supported UPI intent apps for iOS SDK -->

UPI Intent on Recurring Payments

Configure and initiate a recurring payment transaction on UPI Intent:

let options: [String:Any] = [
"key": "YOUR_KEY_ID",  
"order_id": "order_DBJOWzybfXXXX", 
"customer_id": "cust_BtQNqzmBlXXXX",  
"prefill": [
    "contact": "+919000090000",
    "email": "gaurav.kumar@example.com"
],
"image": "https://cdn.razorpay.com/logos/F9Yhfb7ZXjXmIQ_medium.jpg",
"amount": 10000,  // Amount should match the order amount 
"currency": "INR",
"recurring": 1  // This key value pair is mandatory for Intent Recurring Payment.
]

NSDictionary *options = @{
    @"key": @"YOUR_KEY_ID",
    @"order_id": @"order_DBJOWzybfXXXX",
    @"customer_id": @"cust_BtQNqzmBlXXXX",
    @"prefill": @{
        @"contact": @"+919000090000",
        @"email": @"gaurav.kumar@example.com"
    },
    @"image": @"https://cdn.razorpay.com/logos/F9Yhfb7ZXjXmIQ_medium.jpg",
    @"amount": @(10000), // Amount should match the order amount 
    @"currency": @"INR",
    @"recurring": @(1)  // This key value pair is mandatory for Intent Recurring Payment.
};

Using Razorpay you can let your customers make UPI Intent payments on your mobile website. For example, when the customer selects a UPI PSP, the PSP app opens automatically. Customers can then proceed with the payment without navigating away from your mobile website. This leads to a faster checkout experience with higher success rates.

Feature EnablementThe UPI Intent feature is usually available by default. If you are unable to access this feature, contact our Support Team to get this enabled on your account.

Features

The UPI intent on mobile web is available at Razorpay Standard Checkout and other products such as Payment Links, Payment Pages and Invoices.
It works for UPI PSP apps.

Watch Out!By default, the top PSP apps appear on the customer’s mobile irrespective of the installation status of the UPI apps.

It works on Android and iOS smartphones.

Prerequisites

Sign up for a Razorpay account.
Generate API Keys from the Dashboard.
Integrate Razorpay Standard Checkout on your Website.

Standard Checkout

UPI Intent for mobile websites works automatically if the intent flow is enabled on your account. You can enable UPI Intent in WebView on your Android appor iOS app.

List of Supported UPI Intent Apps

Given below is the list of supported UPI apps for Mobile Web:

Android

Sr. No	App Name
1	Google Pay
2	PhonePe
3	CRED
4	PayTM
5	BHIM
6	AmazonPay
7	iMobile by ICICI
8	PayZapp
9	Mobikwik
10	Navi

iOS

Sr. No	App Name
1	Google Pay
2	PhonePe
3	CRED
4	PayTM
5	BHIM

Best Practices

Following are the best practices to be followed to accept online payments using UPI intent flow. You must show the list of UPI apps in 2 sections:

Top performing apps (GPAY > PhonePe > Paytm > BHIM)
Other apps

​Benefits

​Understand Intent flow

​Integrate on Android, iOS and Mobile Web

​Installation

​Initialisation

​Passing Result to Razorpay

​Prerequisites

​iOS Standard Checkout

​UPI Intent on Recurring Payments

​Features

​Prerequisites

​Standard Checkout

​List of Supported UPI Intent Apps

​Android

​iOS

​Best Practices

​Related Information

Benefits

Understand Intent flow

Integrate on Android, iOS and Mobile Web

Installation

Initialisation

Passing Result to Razorpay

Prerequisites

iOS Standard Checkout

UPI Intent on Recurring Payments

Features

Prerequisites

Standard Checkout

List of Supported UPI Intent Apps

Android

iOS

Best Practices

Related Information