Payment Page rendering

To accept UPI Intent payments on EBANX, render a Payment Page 2.0 in your client application by following the instructions in Integrate Payment Pages 2.0. When you call Z.render or Z.renderWithErrorHandler, pass the client parameters described in the following sections to control the UPI Intent flow.

To render the Payment Page, call the Z.render function and pass the following items:

• A params object that contains the page identity values returned by the signature API (tenantId, id, token, signature, and key), together with the UPI Intent client parameters that control the flow.
• A prepopulated fields object.
• A callback function that handles the response after your customer completes the payment.

The following example shows a client-side render pattern for UPI Intent. Replace the sample values with values for your tenant and your transaction:

var params = {
  tenantId: "<tenantId>",
  id: "<UPI Intent Payment Page ID>",
  token: "<token>",
  signature: "<signature>",
  key: "<key>",
  style: "inline",
  submitEnabled: "true",
  locale: "en",
  field_currency: "INR",
  doPayment: true,
  storePaymentMethod: false,
  field_accountId: "<Zuora account ID>",
  field_authorizationAmount: "100.00",
  param_gwOptions_shopperEmail: "customer@example.com",
  param_gwOptions_phoneNumber: "+919999999999"
};

function callback(response) {
  if (response.success) {
    // response.refId is the ID of the UPI Intent payment method created in Zuora.
    // Use it to look up the payment method or the resulting payment.
  } else {
    // Handle the failure using response.errorCode and response.errorMessage.
  }
}

Z.render(params, {}, callback);

After Zuora renders the page, your customer selects a UPI app and approves the payment in that app. Zuora then invokes your callback function with the result.

Client parameters

The following table lists the client parameters that you can pass for EBANX UPI Intent payments.

Mandate parameters

When you store a payment method for UPI Autopay, you can optionally provide the mandate parameters described in the following table. If you do not provide them, Zuora applies the EBANX default values.

Parameter combinations

The combination of doPayment and storePaymentMethod determines the flow, as described in the following table.