Welcome to Zuora Product Documentation

Explore our rich library of product information

Create a UPI QR Payment Page for EBANX

Learn how to create and configure a hosted payment page for the UPI QR payment method through EBANX.

Before you begin, ensure that the following prerequisites are met:

  • The UPI QR payment method type is enabled for your tenant. If UPI QR is not available when you create a payment page, contact Zuora Global Support to enable it.

  • You have an active EBANX merchant account with UPI enabled, and you have the Integration Key and Public Integration Key from the EBANX dashboard.

  • Real-time reconciliation is enabled. For more information, see Enable and configure real-time reconciliation for EBANX.

  1. In the Zuora UI, navigate to Settings > Payments, and click Setup Payment Page and Payment Link.
  2. On the Payment Pages tab, configure the tenant-level settings for the hosted payment page.
  3. In the Type list, select UPI QR.
  4. Click Create New Hosted Page.
  5. In the Basic Information section, specify the following fields:

    Field

    Description

    Page Name

    Enter a name for your hosted payment page. Zuora uses this name to identify the payment page. The name differs from the title that is displayed on the payment page. You can specify the title in the Page Title field of the Page Configuration section.

    Hosted Domain

    Enter the domain address from which your payment page is served. This domain also hosts your callback page. Use the format https://www.domain.com.

    Zuora validates this field. If the validation fails, an error message appears on the payment page. The Overlay Hosted Page mode does not support hosted domain validation.

    To host your payment pages and callback pages in a subdomain of the hosted domain, enable the tenant-level Allow Subdomain Callback for Hosted Pages setting.

    Callback Path

    Enter the path where the callback page file resides. Zuora appends this path to the Hosted Domain entry to create the full URL to which the callback is sent. Use the format /app/callback_file.jsp. The file extension, such as .jsp or .php, is not required, but the callback path must begin with a forward slash (/).

    The Callback Path is required only for the advanced implementation option, which uses the inline style form with an external submit button. Zuora ignores this setting for the basic setup, which uses the overlay form or the inline form with the submit button inside.

  6. In the Payment Gateway section, click the Default Payment Gateway field and select an Adyen Integration v2.0 instance.
    Note: Zuora does not validate this setting. You can override this default gateway in your request by specifying a gateway through the paymentGateway client parameter.
  7. In the Page Configuration section, complete the field configuration:

    Field

    Description

    Page Title

    Enter a title for the hosted payment page. Select Display to show the page title on the payment page.

    Page Description

    Enter a description for the payment page. Select Display to show the page description on the payment page.

    CSS

    Enter the custom CSS code for your page. To review the CSS IDs and class names, use View Source or Inspect Element in Firefox or Chrome on the preview page. For example, you can customize the style and format of the field label, the error message, and the error message text.

    Note: Custom JavaScript is not allowed for security reasons. The UPI timer window designed by Zuora cannot be modified.
  8. Click Generate and Save Page.

The UPI QR hosted payment page is created. You can now preview the form.