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.
Before testing UPI Intent with Adyen, contact Adyen to enable the UPI Payment Method India simulator with the acquirer account HDFCIndiaRecurringSimulatorAcquirerAccount for your test environment. This is a mandatory prerequisite for testing. After the simulator is enabled, use the Adyen test magic numbers to validate the supported scenarios.
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.
Enablement of zero-amount validation (optional)
- Zero-amount validation for UPI on Adyen is not enabled by default.
- To use zero-amount validation , you only need to set the default amount on the gateway instance and send
gwOptions_additionalAmountthrough HPM. No additional gateway configuration is required for this step.
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 |
gwOptions_additionalAmount | Use this option to pass a non-zero additional amount in a payment method verification request through HPM. | 200 | N/A |