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

Step 1. Prepare for the integration

Ensure all prerequisites are met before integrating KaKaoPay with Adyen, including activating the payment method and configuring the gateway instance.

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

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

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

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

Prerequisites

The last two prerequisites are not applicable to KaKaoPay:

  • The setting for recurring fields in the API response must be enabled…(See this article for a full description)

  • To ensure the network transaction ID (NTI) is returned...(See this article for a full description)

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

KaKaoPay 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 KaKaoPay 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