UPI via Adyen

​

Supported workflows

​

Before you begin

1. Set up an Adyen integration in your workspace. Follow the Adyen integration setup guide if you don’t have one yet.
2. Ask Adyen to enable UPI on your Adyen merchant account.
3. In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select UPI under Payment methods, and save.
4. Add UPI as a payment option in your workflow.

​

Request fields for Adyen

​

Choose the journey

1. When meta.paymentMethods.upi.flow is qr, Payrails shows a QR code on a Payrails-hosted page. The customer scans it with any UPI app.
2. When flow is intent, the response redirects the customer to the UPI app you name in appId.
3. Without a flow, Payrails uses the intent journey when you send an appId, and the QR code journey when you don’t.

​

Authorize a UPI payment

{
  "amount": {
    "value": "500.00",
    "currency": "INR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "upi",
      "amount": {
        "value": "500.00",
        "currency": "INR"
      }
    }
  ],
  "meta": {
    "paymentMethods": {
      "upi": {
        "flow": "intent",
        "appId": "gpay"
      }
    },
    "customer": {
      "email": "aarav.sharma@example.com",
      "name": "Aarav",
      "lastName": "Sharma",
      "country": {
        "code": "IN"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Adyen handles UPI

• Adyen captures UPI payments automatically. When Adyen confirms the authorization, Payrails also records the capture, so the payment completes in one step.
• Payrails sends every UPI payment to Adyen as a new intent or QR code payment, never as a charge against a stored token. Save Instruments and merchant-initiated transactions (MIT) aren’t available for UPI through Adyen.
• Payrails still reads meta.upi.flow and meta.upi.appId from older integrations. Use meta.paymentMethods.upi for new integrations.