Welcome to Zuora Product Documentation

Explore our rich library of product information

Set up your client code for Payment Pages 2.0 in Opayo Payment Gateway Integration

Learn how to configure client code for Payment Pages 2.0 in Opayo, including required parameters for one-time payment flows and invoice processing.

Follow the instructions in Integrate Payment Pages 2.0 . When rendering the Payment Page, specify the following required parameters in the Z.render or Z.renderWithErrorHandler function. For other optional parameters, see Client parameters for Payment Pages 2.0 .

Table 1. Required client parameters for Opayo one-time payment flows
ParameterTypeDescription
doPaymentboolean Required. Default: false. true indicates that the Payment Page will create a payment method as well as process the one-time payment transaction. If it is false or not specified, the Payment Page will only create a payment method. To implement a one-time payment flow, doPayment must be true.
storePaymentMethodboolean Type: boolean. Default: true. true indicates that the payment method will be stored in Zuora and used in subsequent recurring payments. false indicates that the payment method will not be stored in Zuora. End-customers need to be brought back on-session to authenticate subsequent payments.
field_accountIdstring Required. Zuora customer account ID. The payment method will be created for this specified account. Example: 8a90e5e48f2eade6018f2ed19133003a.
authorizationAmountnumber Required for authorization amount processing. The amount of the one-time payment that will be sent to the gateway. For more information about this parameter, see Client parameters for Payment Pages 2.0 .
field_currencystring Required for authorization amount processing. The currency of the one-time payment amount. For more information about this parameter, see Client parameters for Payment Pages 2.0 .
documentsarray Required for invoice processing. An array of invoices to be paid in this transaction, containing the following fields:
  • type - The value must be invoice.
  • ref - The value must be the invoice number, such as INV0000001.

Here is an example for authorization amount processing:


var params = {
    doPayment:"true",
    storePaymentMethod:"true",
    field_accountId:"testc0f87596f2f301759c29443622fa",
    authorizationAmount:"99",
    field_currency:"USD"
};
  

Here is an example for invoice processing:


var params = {
    doPayment:"true",
    storePaymentMethod:"true",
    field_accountId:"testc0f87596f2f301759c29443622fa",
    documents:"[{\"type\": \"invoice\", \"ref\": \"INV0000001\"}, {\"type\": \"invoice\", \"ref\": \"INV0000002\"}]"
};