S2S UPI Intent Flow

Best Practices

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

   m-site integration

   . This will help you achieve better success rates.
5. Gpay SDK
   If your UPI transaction volumes are high, you can also explore integrating

   Gpay SDK

   . This provides a better user experience and about a 3-5% improvement in success rate.

Prerequisites

• Reach out to our

  Support Team

  to get this feature enabled for your account.
• Keep the API keys (Key_Id and Key_Secret) handy for integration.

• Generate API Keys from the Dashboard

  if you have not done already.

Integration Steps

1. Create an order

   .

2. Initiate Payment using the intent URL

   .

3. Verify the payment status

   .

Step 1: Create an Order

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

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X POST https://api.razorpay.com/v1/orders \
-H "Content-Type: application/json" \
-d '{
  "amount": 200,
  "currency": "INR"
}'

Request Parameters

Step 2: Initiate a Payment

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

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -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": "192.168.0.103",
    "referer": "http",
    "user_agent": "Mozilla/5.0",
    "description": "Test flow",
    "notes": {
      "purpose": "UPI test payment"
    },
    "upi": {
		  "flow" : "intent"
	  }
  }'

Request Parameters

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

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

Step 3: Verify the Payment Status

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

• Poll Razorpay servers periodically for the payments made for the order using our

  Fetch Payment APIs

  .

• Subscribe to the Webhook events

  created in our system for each of the following entities:

  • payments

  • orders

Payment failure and re-initiating payment

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

Related Information

• Error reasons