UPI via PayU India

​

Supported workflows

​

Before you begin

1. Set up a PayU India integration in your workspace. Follow the PayU India integration setup guide if you don’t have one yet.
2. Ask PayU India to enable UPI on your PayU India merchant account.
3. In the PayU dashboard, create the successful and failed payment webhooks with your Payrails notification URL. Payrails receives the UPI payment result through them. The setup guide shows the steps.
4. In the Payrails Portal, go to Settings → Integrations, open your PayU India integration, select UPI under Payment methods, and save.
5. Add UPI as a payment option in your workflow.

​

Request fields for PayU India

​

Authorize a UPI payment

{
  "amount": {
    "value": "500.00",
    "currency": "INR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "upi",
      "amount": {
        "value": "500.00",
        "currency": "INR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Aarav",
      "lastName": "Sharma",
      "email": "aarav.sharma@example.com",
      "phone": {
        "countryCode": "91",
        "number": "9876543210"
      }
    },
    "order": {
      "description": "Order 1234"
    },
    "clientContext": {
      "ipAddress": "203.0.113.10",
      "userAgent": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Mobile Safari/537.36",
      "osType": "android"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

Choose the journey

• UPI intent: when meta.clientContext.osType is android or ios, or the user agent belongs to a phone or tablet, the redirect is a upi:// deep link that opens the customer’s UPI app.
• QR code: on any other device, Payrails shows a QR code on a Payrails-hosted page, and the customer scans it with any UPI app.

{
  "meta": {
    "paymentMethods": {
      "upi": {
        "flow": "qr"
      }
    }
  }
}

​

How PayU India handles UPI

• PayU India captures UPI payments immediately.
• PayU India signs each payment webhook with your merchant salt, and Payrails verifies the signature before it updates the payment.
• Payrails sends full and partial refunds to PayU India against the original transaction. PayU India completes refunds in the background, and Payrails checks the status until it gets a final result.