Welcome to Zuora Product Documentation

Explore our rich library of product information

Create and configure a GCash payment page

Learn how to create and configure a GCash payment page in Zuora, including setting up tenant-level settings and specifying necessary fields.

A GCash payment page lets you collect GCash one-time and recurring payments through a hosted page. Complete the following steps to create and configure a GCash payment page.

Note: Google reCAPTCHA is not supported for GCash payment pages.
  1. In the Zuora UI, navigate to Settings > Payments, and then 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 GCash.
  4. Click Create New Hosted Page.
  5. In the Basic Information section, specify values for the following fields:

    Field

    Description

    Page Name

    Enter a name for the hosted payment page. Zuora uses this name to identify the payment page internally. The page name is different from the title that appears on the payment page itself. To set the displayed title, use the Page Title field in the Page Configuration section.

    Hosted Domain

    Enter the domain address that serves the payment page. This domain also hosts the callback page. Use the following format: https://www.domain.com.

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

    To host 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 value to the Hosted Domain entry to build the full callback URL. 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, select an Adyen Integration v2.0 instance in the Default Payment Gateway field.

    Zuora does not validate this setting. To override the default gateway in a request, specify 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 hosted payment page. Select Display to show the page description on the payment page.

    Submit Button

    Not applicable to GCash. Skip this field.

    Client-Side Validation

    Not applicable to GCash. Skip this setting.

    CSS

    Not applicable to GCash. Skip this field.

  8. Click Generate and Save Page.

The GCash payment page is created and ready for use. You can now preview the form to verify its appearance and behavior.