Skip to content

PG settings

'PG settings' is the screen where you decide the payment gateway (PG) providers that process payments and set the countries where payment is available and the payment methods for each PG provider. You also register the credentials issued by PG providers on this screen.

➡️ Console path: Payment > PG Settings

The Default settings tab of the Payment > PG Settings screen. Below the payment notification URL field are the Settings buttons and the supported countries fields for PortOne, MyCard, and Xsolla, and at the bottom is the customer service URL field.

PG payments are used only with App IDs whose store is Direct distribution. Direct distribution App IDs for Windows and macOS fall into this category, and you cannot set up PG payments for Google Play and App Store App IDs. You cannot change the runtime environment or store after you create an App ID, so if you have no direct distribution App ID, create a new one in Create an App ID.

Credentials to get from the PG provider

Get the credentials from the PG provider you will use. The issuance procedure for each PG provider is as follows.

  • PortOne: In the PortOne console, register the IAP server callback URL and configure the PG provider, and then get the merchant ID, REST API Key, and REST API Secret
  • Xsolla: Contact Xsolla to get the project ID and Secret Key
  • MyCard: Generate the Hash Key in MyCard, and then submit the generated key, the IPs and URLs to use for payment, and registration information to MyCard to receive the FacServiceId

Also prepare the URL to receive payment information when a payment is completed.

Register the payment notification and customer service URLs

In Payment notification settings, enter the URL to receive payment information when a payment is completed. This URL is used in common regardless of the PG provider.

In Customer service URL, enter the address to go to when the user selects Customer service on the PG payment page. If you leave it empty, the Customer service button does not appear on the payment page, so enter a value to guide users to a payment inquiry channel.

Specify payment countries for each PG provider

Decide which PG providers to use among PortOne, MyCard, and Xsolla, and choose the countries where each PG provider allows payment. If you choose All at the top of the list, all countries are selected together.

A country can be assigned to only one PG provider. You cannot choose a country assigned to one PG provider for another PG provider, and if you choose All for one PG provider, you cannot choose countries for other PG providers. To use multiple PG providers together, divide the countries among them.

You do not need to assign countries to every PG provider. Save PG providers you will not use with their countries left empty.

Set PG provider credentials and payment methods

Select Settings on a PG provider card to open the settings screen for that PG provider. Here you enter the credentials and choose the payment methods to use.

PortOne

Register the payment notification (Webhook) URL in the PortOne Admin Console, then enter the credentials required by the Hive Console.

1. Register the payment notification (Webhook) URL

  1. In the PortOne Admin Console, go to Payment Integration > Integration Information.
  2. Select the Payment Notification (Webhook) Management tab.
  3. Register the URL for the environment you use.
Environment Webhook URL
Live https://commerce-api.hiveaxyl.com/payment/v1/webhook/portone
Test https://sandbox-commerce-api.hiveaxyl.com/payment/v1/webhook/portone

2. Check and enter the credentials

  1. In the PortOne Admin Console, go to Payment Integration > Integration Information > V1 API.
  2. Check the merchant ID, REST API Key, and REST API Secret.
  3. Enter the same values on the PortOne settings screen in the Hive Console.

Enter the following additional values when they apply:

  • Tier code: Enter this when you created sub-stores to operate multiple payment channels within one project. You can find the tier code in Settings > Sub-store Management in the PortOne Admin Console.
  • Chain ID (NAVER PAY): Enter this when you use NAVER Pay. You can get the Chain ID when you sign a contract with NAVER Pay.

Enter a tier code and Chain ID only when applicable. Otherwise, leave them empty.

3. Set payment methods

Payment methods are grouped by payment channel, so choose the methods to use for each channel. Each channel shows whether it is for Live or Test integration; configure the channels for actual payments and testing separately.

MyCard

Enter the FacServiceId you received from MyCard.

The Hash Key is created when you select Auto-generate to the right of the input field. You receive the FacServiceId only after you submit this key to MyCard, so first generate and save the key, and then fill in the value you received from MyCard.

Xsolla

  1. In the Xsolla Admin Console, go to Project Settings > Webhooks > General Settings.
  2. Check the Project ID and Secret Key.
  3. Enter the same values on the Xsolla settings screen in the Hive Console.

Payment methods

You cannot set payment methods separately for each country. The country list on the Xsolla settings screen shows only the countries assigned to Xsolla on the PG Settings screen, and All is selected by default. When you change the country, only the payment methods supported in that country appear in the list. However, selecting or deselecting a payment method applies to every country that supports it.

Save order

The PG provider settings screen and the PG settings screen are saved separately, so after you save the PG provider settings, you must save once more on the PG Settings screen for the URLs and country information to take effect.

How to set up:

  1. Enter the URL to receive payment information and the customer service URL.
  2. On the card of each PG provider to use, choose the countries where payment is allowed.
  3. Select Settings on the PG provider card, enter the credentials and payment methods, and select Save on the settings screen.
  4. Select Save on the PG Settings screen to save the URLs and the country information for each PG provider.

Per-App ID PG settings

If you use different PG providers or payment methods for each App ID, register individual settings on the Per-App ID settings tab. This tab shows only App IDs whose store is Direct distribution.

The Use default settings toggle works the same way as in Store settings. For details on how it works, see Configure credentials per App ID. When you turn this item off, you set the PG provider countries, credentials, and payment methods for that App ID individually.

How to set up:

  1. On the Per-App ID settings tab, choose the App ID to configure.
  2. Turn off Use default settings.
  3. Enter the countries and PG provider settings to apply to that App ID.
  4. Select Save.

Next steps