Skip to content

PortOne

To provide PG payment services through PortOne, configuration is required. Based on the App ID, you set the country for service and connect and manage payment methods.

Preparation Requirements

It is essential to register the payment notification (Webhook) URL required for payment processing by accessing the PortOne admin console.
The billing server will verify the data received through the payment notification (Webhook) URL as soon as the payment is completed at PortOne, and only if the integrity is confirmed will the payment be finalized. If the settings are missing, the payment will not be processed, so please complete the setup according to the steps below.

How to Set Up:

  1. Access the PortOne admin console.
  2. Go to Payment Integration > Integration Information.

  3. Click on the Payment Notification (Webhook) Management tab and register the URL as follows:

    image

  4. Separate the live integration and testing, and enter the URL accurately in the PortOne admin console.

  5. If you set the PG company to test in the PortOne console, the payment history will be automatically canceled the next day. Games in commercial service must be set to live integration.

Setting up PG

Set up the payment methods to be used by service countries by linking PortOne information.

➡️ Console Path: Billing > Payment Settings > PG Settings

  1. Click the 'Edit' icon of the App ID that requires PG settings, or select the App ID and click the [Edit] button to go to the PG settings page. To apply the same PG settings to multiple App IDs, select all the desired App IDs and then click the [Edit] button. The same settings will be registered in bulk for the selected App IDs.

    image

  2. Move to the PG settings page and proceed with the service country and detailed settings. If you want to load and overwrite the PG settings information of another App ID, use the [Load Existing Settings] feature.

    image

  3. Select the country where you will provide the PortOne service.

    • One country can only connect to one PG platform. For example, in 'South Korea', you can only choose one PG platform among PortOne, Xsolla, or MyCard to provide the service.
    • If you have set the service country, click the [PortOne Settings] button to proceed with the detailed settings.

    image

  4. Enter the basic information required for PortOne payment integration.

    image

    • Access the V1 API in the PortOne admin console > Payment Integration > Integration Information to check the customer identification code, REST API key, and REST API Secret information, and enter the same in the Hive console.
    • If you have created sub-stores to operate various payment channels for a single project in PortOne, check the information in the PortOne admin console > Settings > Sub-store Management > Tier Code and enter the tier code in the Hive console.
    • If you are using Naver Pay, enter the Chain Id. The Chain Id can be obtained when signing a contract with Naver Pay.

    [PortOne Admin Console] image
    image

  5. When the client identification code, REST API key, and REST API Secret information are entered, the information registered in the PortOne admin console will be automatically retrieved and displayed in the payment method information area. The user selects the payment method to be offered from the list of available payment methods.

    image

    • A single payment method can only be connected to one payment gateway (PG). For example, if you selected a credit card with KG Inicis, you cannot select a credit card with another PG.
    • Clicking the [Preview] button will launch the test payment page with the selected payment method. Please confirm that the payment is processed correctly.
    • If a payment test page is needed during the PG contract process, copy the URL of the preview page and provide it to the PG for use.

Next Steps

All setup steps for PG payment have been completed.
If you are using Hive SDK version 4.25.1.0 or lower, or if you are servicing the Hive web store, you must complete the 'Payment Notification Settings' to ensure all preparations for PG payment services are complete. See more