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 MoMo on Adyen Integration v2.0

Step 1. Prepare for the integration

Ensure all prerequisites are met before integrating the MoMo payment method on Adyen.

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

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

  • Complete the following steps to activate the MoMo 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 MoMo and click Save .

To configure an Adyen gateway instance for processing MoMo 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 MoMo transactions.

Prerequisites

The following prerequisite is not applicable to MoMo, 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

Additional Metadata

MoMo 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.

For the Auto-capture IP Address setting, turn it on to ensure that the IP address is always included in your request as passing the IP address is required for Adyen MoMo on-session transactions. The following list describes the priority of passing in the IP address:

  • If the IP address is provided through the gwOptions_shopperIP gateway options field, this value is used regardless of the Auto-capture IP Address setting.

  • If the gwOptions_shopperIP field is not specified and the Auto-capture IP Address setting is turned on, the browser's IP address is automatically included in the request.

  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 MoMo transactions, you must turn on 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 turned on:

    • 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