Welcome to Zuora Product Documentation

Explore our rich library of product information

Render the Payment Pages 2.0 Form

The Z.render function takes the client parameters, pre-populated fields, and the callback function and loads the Payment Pages 2.0 form on your client web page.

The following table lists the input parameters to the Z.render function.

Parameter

Required?

Description

params

Required

Parameters for customizing this Payment Pages 2.0 form.

prepopulateFields

Required

Parameters with field ids and values to be pre-populated on the form.

If you do not want to pre-populate any field, pass in an empty set. For example:

var prepopulateFields = {}

callback

Required

The callback function that handles the response returned after the form is submitted.

The following is a sample call to the Z.render function:

Z.render(
   params,
   prepopulateFields,
   callback
);

If you are implementing custom error handling for Payment Pages 2.0, use the Z.renderWithErrorHandler function instead of Z.render . See Customize Error Handling for Payment Pages 2.0 for information about Z.renderWithErrorHandler .

The size of Zuora’s iFrame will be automatically adjusted based on the elements and content within iFrame. For example, Zuora will resize iFrame to properly handle the CAPTCHA challenges or the 3DS2 challenges. If you want to customize iFrame resizing, it is recommended to use the Z.renderWithErrorHandler function to implement your resizing logic.

Note:

Before invoking Z.render or Z.renderWithErrorHandler , the callback function must be implemented.