S2S UPI Intent Flow

Enable payments on your apps using the UPI Intent flow applicable in server-to-server integration.

You can collect payments using the UPI intent flow that will be handled by UPI apps installed on your customers' mobile devices.

Customers need not enter VPA or phone numbers as these details are prefilled and submitted along with the other payment details. While making the payment, customers select the UPI PSP app on your UI. The app is launched automatically on their mobile devices where the payment is completed.

If you have a significant amount of payment traffic coming from the Mobile Site, then it is advisable to use the Google Pay Intent flow available for the mSite:

  1. Do not change Intent URL
    Do not make changes to the intent URL shared by Razorpay as part of the API response. Making changes to the intent URL can lead to payment failure.
  2. Host UPI apps
    It is recommended to host the UPI apps on your page/app instead of just hosting the Intent URI where the apps are shown by the native Android drawer. This improves conversion.
  3. Rank UPI Apps by Success Rate
    Show the UPI PSP apps in the order of their success rate.
  4. Mobile site
    If you have higher traffic via mobile site, then make sure you provide the option of UPI intent payment to your users using our . This will help you achieve better success rates.
  5. Gpay SDK
    If your UPI transaction volumes are high, you can also explore integrating . This provides a better user experience and about a 3-5% improvement in success rate.

  1. .
  2. .
  3. .

You should create an order before initiating a payment at your end.

-X POST https://api.razorpay.com/v1/orders \
-H "Content-Type: application/json" \
-d '{
"amount": 200,
"currency": "INR"



integer The amount for which the Order was created, in currency subunits.
For example, for an amount of ₹295, enter 29500.



string ISO code of the currency associated with the payment amount. Only INR is supported.



string Receipt number that corresponds to this order, set for your internal reference. Maximum length of 40 characters supported.



json object Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

After creating an order, initiate a payment with intent flow.

-X POST https://api.razorpay.com/v1/payments/create/upi \
-H "Content-Type: application/json" \
-d '{
"amount": 100,
"currency": "INR",
"order_id": "order_Ee0biRtLOqzRjP",
"email": "gaurav.kumar@example.com",
"contact": "9090909090",
"method": "upi",
"ip": "",
"referer": "http",
"user_agent": "Mozilla/5.0",
"description": "Test flow",
"notes": {
"purpose": "UPI test payment"
"upi": {
"flow" : "intent"

Do not make changes to the link

Do not make changes to the link you receive in the response. This is the Razorpay Intent URL. Making changes to this URL can lead to payment failure or other unexpected errors with the payment.

The parameters needed for constructing the API request are described below:



integer The amount associated with the payment in smallest unit of the supported currency. For example, 2000 means ₹20.



string ISO code of the currency associated with the payment amount. In this case, it is INR.



string Unique identifier of the order, obtained from the response of the previous step.



string Phone number of the customer.



string Email address of the customer.



string Client's browser IP address. For example,



string Value of thereferer header passed by the client's browser. For example, https://example.com/.



string Value of the user_agent header passed by client's browser. For example, Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36.



string Descriptive text of the payment.



json object A key-value pair that can hold additional information about the payment.
Refer the

section of the API Reference Guide.



Details of the UPI payment.


string Type of the UPI method. In this case, it is intent.

You will get the UPI Intent URI as part of the payment response.

To pass the payment data to the respective UPI app and to initiate the payment, implement the code given below:

Intent i = new Intent(Intent.ACTION_VIEW);
i.setData(Uri.parse(url)); //uri from the create S2S payment response
i.setPackage(packageName); //package name from the `upi://pay` intent response
activity.startActivityForResult(i,2561); //unique activity code to get the callback

Handy Tips

For the package name, you can check the


You can verify the status of the payments using any of the following methods:

If the Order is not marked paid within 2-3 minutes, then you can re-initiate payment for the same.

Is this integration guide useful?