Prepare for the UPI integration for EBANX payment gateway integration
Learn how to enable and configure UPI for EBANX payment gateway integration, including steps for activation, configuration, and transaction processing.
UPI enablement and configuration
Complete the following steps to activate the UPI payment method type on your tenant:
- Click your username in the upper right and navigate to Settings > Payments > Payment Method.
- Click Edit at the bottom of the page.
- Select UPI and click Save.
EBANX gateway instance configuration
To configure an EBANX gateway instance for processing UPI transactions, follow the instructions in Set up and configure an EBANX gateway instance .
In particular, you can skip the following requirements and settings as they do not apply to UPI transactions:
-
Additional Metadata- UPI does not support Additional Metadata.
Settings with fixed values for UPI
| Setting | Value passed to EBANX |
|---|---|
| UPI country and currency | For all UPI payments processed through EBANX, Zuora always sends country = IN and currency_code = INR. UPI on EBANX is only available for INR transactions; these values are fixed by the integration and cannot be overridden through the gateway instance settings. |
| UPI Autopay mandate defaults | These defaults are set by design; to change them, use the appropriate [param_]gwOptions_* gateway options when invoking Hosted Payment Pages 2.0, Payment Form, or the API. For more detailed information, see Default Mandate Parameters. |
Zuora sends below default mandate parameters but can be overridden by the indicated gateway parameters :
| Parameter | Default | Customizable via |
|---|---|---|
| subscription_name | Computed | gwOptions_subscription_name |
| expiration_date | Current + 10 years | gwOptions_expiration_date |
| frequency | "ondemand" | gwOptions_frequency |
| min_amount | "1.00" INR | gwOptions_min_amount |
| max_amount | "15000.00" INR | gwOptions_max_amount |
| start_date | None | gwOptions_start_date (optional) |
Enablement of zero-amount validation
Zuora does not support zero-amount validation. By default a minimum amount is used to create a mandate.
Real-Time Reconciliation setup
To process UPI transactions, you must enable Real-Time Reconciliation. For more detailed information, seeEnable and configure Real-Time Reconciliation for EBANX.