Welcome to Zuora Product Documentation

Explore our rich library of product information

Create and configure a KaKaoPay payment page

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

Complete the following steps to create and configure a KaKaoPay payment page:

Currently, Google reCAPTCHA is not supported.

  1. In Zuora UI, navigate to Settings > Payments , and click Setup Payment Page and Payment Link .
  2. On the Payment Pages tab page, configure the tenant-level settings for the hosted payment page .
  3. In the Type dropdown list, select KaKaoPay .
  4. Click Create New Hosted Page .
  5. In the Basic Information section, specify the following fields:

    Field

    Description

    Page Name

    Enter a name for your hosted payment page. This name is used to identify your payment page in Zuora. It is different from the title displayed on the payment page. You can specify the title in the Page Title field in the Page Configuration section.

    Hosted Domain

    Enter the domain address from which your payment page is served. This domain also hosts your callback page. The value must be in the format: https://www.domain.com .

    Zuora validates this field for you. If the validation fails, an error message is displayed on the payment page. Note that the Overlay Hosted Page mode does not support the hosted domain validation.

    If you want your hosted payment pages and callback pages to reside in the subdomain of the hosted domain, enable the tenant-level Allow Subdomain Callback for Hosted Pages setting.

    Callback Path

    Enter the path on which the callback page file resides. Zuora appends this to the Hosted Domain entry to create the full URL to which the callback is sent. Specify a value in the format: /app/callback_file.jsp . The file extension, such as .jsp or .php, is not required. However, the callback path must begin with a forward slash character ( / ).

    The Callback Path is only required for the advanced implementation option, which uses the inline style form with an external submit button. This setting is ignored for the basic setup, which uses the overlay form or the inline form with the submit button inside.

  6. In the Default Payment Gateway field of the Payment Gateway section, click and select an Adyen Integration v2.0 instance. Note that Zuora does not validate this setting. You can override this default gateway in your request by specifying 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 display the Page Title on this payment page.

    Page Description

    Enter the description of the payment page. Select Display to display the Page Description on this payment page.

    Submit Button

    This field is not applicable to KaKaoPay. Skip it.

    Client-Side Validation

    This setting is not applicable to KaKaoPay. Skip it.

    CSS

    This field is not applicable to KaKaoPay. Skip it.

  8. Click Generate and Save Page .

Subsequently, you can preview the form .