home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Implement GCash on Adyen Integration v2.0

Step 1. Prepare for the integration

Ensure all prerequisites are met before integrating GCash with Adyen, including requesting support and configuring settings.

Before implementing the GCash payment method on Adyen, ensure that all prerequisites outlined in the following sections are fulfilled.

  • Ensure you have requested support for GCash on Adyen Integration v2.0 through the Specialized Payment Connections service.

  • Complete the following steps to activate the GCash payment method type on your tenant:

    1. Click your username in the upper right and navigate to Settings > Payments > Payment Method .

    2. Click Edit at the bottom of the page.

    3. Select GCash and click Save .

To configure an Adyen gateway instance for processing GCash transactions, follow the instructions in Set up and configure an Adyen Integration v2.0 gateway instance .

In particular, you can skip the following requirements and settings as they do not apply to GCash transactions.

Section

Non-Applicable Requirements and Settings

Prerequisites

The following prerequisite is not applicable to GCash, which is the last prerequisite item in this article .

“To ensure the network transaction ID (NTI) is returned from Adyen and saved in Zuora for processing recurring payments, you must enable the Network transaction reference setting at the Adyen side.”

Credentials

  • Merchant Account for Payouts User Account

  • API Key for Payouts User Account

  • Merchant Account for Review & Confirm Payouts User Account

  • API Key for Review & Confirm Payouts User Account

Rules

  • Enable gateway reconciliation

  • Reconciliation Username

  • Reconciliation Password

  • Enable Level 2 Processing

  • Enable Level 3 Processing

  • ShipFrom Postal Code API Name

  • ProductCode Custom Field API Name

  • CommodityCode Custom Field API Name

  • Skip Risk Rules

  • Soft Descriptor

  • Submit Card Payments with RecurringDetailReference

  • Tokenize payment method

  • Auto-capture IP Address

Additional Metadata

GCash does not support Additional Metadata.

For the following settings, specific values are passed to the gateway, regardless of the values configured in these settings in the UI.

Setting

Value passed to Adyen

Shopper Interaction

  • For one-time payments: Ecommerce

  • For recurring payments: ContAuth

There is no way to override these values.

Recurring Processing Model

Subscription

If you want to override it, use the param_gwOptions_recurringProcessingModel gateway options field.

  1. Contact Adyen to enable AUTHORISE_ZERO.
  2. Contact Zuora to enable zero-amount validation by submitting a support ticket at Zuora Global Support . Include your tenant ID in your request.

To process GCash transactions, you must enable Real-Time Reconciliation. Follow the instructions in Enable and configure Real-Time Reconciliation for Adyen Integration v2.0 .

  • To support processing authorization amounts, the following features must be enabled:

    • Validate Client-Side HPM Parameters Follow the instructions in Client-side Payment Page parameter to enable it.

    • Either Credit Balance or Invoice Settlement

  • To support processing invoices, the following requirements must be met:

    • Validate Client-Side HPM Parameters must be enabled.

    • The invoices must be posted before the invoices are paid through the one-time payment.

  • To understand the implementation procedure of Payment Pages 2.0 in Zuora, review Payment Pages 2.0 implementation overview .

Last updated: December 5, 2025