Prepare your environment for Adyen UPI Intent integration
Learn how to enable and configure UPI for Adyen Integration v2.0, including tenant-level activation, gateway configuration, and required reconciliation setup for UPI Intent on mobile.
UPI does not support Additional Metadata. If you are configuring UPI-only flows, you can ignore or skip any Additional Metadata settings for this gateway instance. For more detailed information, see Set up and configure an Adyen Integration v2.0 gateway instance.
Settings with fixed values for UPI on Adyen
The following values are fixed by the integration for UPI and cannot be overridden through gateway configuration.
| Country / currency | IN / INR |
shopperInteraction | Ecommerce for one-time payments, ContAuth for recurring payments |
recurringProcessingModel | Subscription |
If needed, use param_gwOptions_recurringProcessingModel in the Payment Pages 2.0 request to override the recurring processing model.
Enable zero-amount validation
Zero-amount validation for UPI on Adyen is not enabled by default.
To use zero-amount validation, for example to create a mandate without charging the customer immediately, contact Zuora Global Support and request that zero-amount validation be enabled for Adyen Integration v2.0 on your tenant. Include your tenant ID in the request.
UPI Autopay mandate configuration for Adyen UPI Intent
Use the following gateway options to configure UPI Autopay mandates for Adyen Integration v2.0 when you invoke Payment Pages 2.0, Payment Form, or the API for UPI Intent flows. This section mirrors the QR configuration topic, but is written for the Intent flow.
gwOptions_UpiMandateEnabled | Enables UPI mandate creation for Autopay when processing UPI Intent payments. | true | N/A |
gwOptions_UpiMandateAmount | Maximum mandate amount for UPI Autopay. This value is required when Autopay is enabled. | 100000 | N/A |
gwOptions_UpiMandateStartsAt | Mandate start date in YYYY-MM-DD format. | 2025-07-21 | N/A |
gwOptions_UpiMandateEndsAt | Mandate end date in YYYY-MM-DD format. | 2030-07-21 | N/A |
gwOptions_UpiMandateRemarks | Free-form description or remark for the mandate. | MandateRemark | Empty |
gwOptions_UpiMandateAmountRule | Amount rule for the mandate. Valid values are max (up to the maximum amount) and exact (fixed amount). | max | max |
gwOptions_UpiMandateFrequency | Billing frequency for Autopay. Valid values are adhoc, daily, weekly, and monthly. | monthly | adhoc |
gwOptions_UpiMandateBillingDay | Billing day of the month (1-31) when gwOptions_UpiMandateFrequency is set to monthly. | 25 | 1 |
gwOptions_UpiMandateBillingAttemptsRule | Rule that determines whether billing attempts occur before or after the scheduled billing day. Valid values are before and after. | before | after |