Hive Crossplay provides PG company with integrated web payment by default.

Hive PG Payment Policy

Category Description
Language
  • 16 languages ​​available
  • The payment screen provided by PG companies supports different languages for each PG company and Hive is not involved.
Function
  • Server-based operation with payment through an external web browser
National Support
  • Expose PG companies of countries that PG companies support
Payment Method
  • The payment method of the contracted PG company and the PG company must be set in the Hive console
PG Payment Currency
  • Hive_country
  • The currency may not be supported depending on the PG company
  • Xsolla allows the users to select their own currency for payments depending on the payment method.
Price Tier
  • Required to upload to Hive console
  • Tier is used for PG payment and does not apply to mobile market
  • Set to tier, not amount when registering a product with an App ID for PC 
  • Each game has its own tier, and a basic tier is provided when creating an App ID for PC.
Product Management
  • Required to register product price, product name, market PID, etc. to Hive console
PortOne Admin Console
  • Direct management required for each game company
  • PG company settings, detailed information inquiry, etc. need to be checked on each game company’s PortOne admin console
Xsolla
  • Direct contract is not needed between game company and payment platform
Refund User Repayment
  • Same support as mobile market

PG Payment Process

① Select a product to purchase in the in-game store
② Expose the payment method selection screen in the web view outside the game screen

  • Language: Game language
  • Currency: hive_country to which the SDK delivers. If there is none, the country is checked by IP and exposed as the currency of the country
  • The product name for payment is displayed in Console > Billing > IAP v4 > Market PID Management. If there is no product name in the language to be exposed, the content entered in the English product name will be displayed.
  • The payment method settings can be made in Console > Billing > PG Payment Settings > PG Company Settings

③ Call the PG company’s payment page for the country and expose it in the web browser

  • Error page is displayed when it’s not the payment target country

④ Go to the completion page when payment is completed. The completion page is displayed in the language of the browser.

Pre-work

1. Proceed with setting up the payment platform to be linked
  • When using Xsolla
    • Project ID and Secret Key
2. Hive Console Settings

 

PG Company Settings Guide

Set up the PG company to be used in the game. Once set up, the PG company cannot be deleted, and can only be deactivated.

① Select Game: Search a game to check the selected PG company. Check the game permissions if you don’t see the game list.
② Add Game: Move to the PG company settings page.
③ View Payment Method by Country: Check the payment method by country of the PG company you have set in the pop-up.
④ Modify: Modify the registered PG company details.

Register PG Company By Game

Click the Add Game button to move to the registration page.

① URL to Receive Payment Results: Enter the server URL if you wish to receive payment completion notification.

② Payment Completion Notification Type: Select the notification type when setting payment completion notification. The default option is to “Send payment success information only”. If you select “Send all,” the server receiving the notification must have branching logic configured for payment success and cancellation types.
③ Service Country: Select the country of use for each PG platform. The bottom entry changes depending on the option selected.

⑤PortOne Information: Enter the same information registered on I’mport console system settings. You must enter the Tier Code if there is a sub-shop. When linking with Naver Pay through direct contract, you must enter the Chain id value.
⑥ Xsolla Information: Copy and enter the project ID and webhook secret key in Xsolla Console > Project Settings > General Settings.
⑦ PortOne – PG Company Payment Method: The list of PG companies set in the PortOne administrator console is automatically loaded. When selecting a payment method to use, check the PG ID and activate it the same as in the PortOne admin console in case of KCP. If the payment method activated by each PG ID is different from the PortOne manager console, it will not be displayed properly.

If you move the horizontal scroll bar to the far right, you will see a button to preview the payment method you have set. If you need a payment test page for a PG contract, copy the URL of the preview page and provide it to the PG company.

⑧ Xsolla – PG Company Payment Method: Select a payment method for each supported country. When you click the Preview, all Xsolla’s activated payment methods are exposed regardless of the country.

PC Payment Inquiry and Cancellation

Check all payment details of PortOne or Xsolla on one page and cancel directly if necessary. Terminal 3 of the Paymentwall sends a payment cancellation request instead of an immediate payment cancellation, and whether the cancellation has been completed must be confirmed in the terminal 3 console.

  • PG Company and Payment Method
    • A list of all PGs provided by the company is provided as an optional selection, regardless of whether the payment method is activated in the PG company settings or not.
  • Status
    • PG
      • Payment Complete – Payment has been successfully completed
      • Payment Failed – Payment failed due to errors during payment, etc.
      • Payment Pending – Payment is not made immediately due to account transfer, etc.
      • Cancellation Request – Request to cancel payment
      • Cancellation Complete – Payment is canceled properly. Terminal 3 payment cannot be confirmed whether cancellation has been completed or not
      • Cancellation Failed – Cancellation request failed
      • Incomplete – Payment is not completed because a user closed the payment window or clicked Cancel Payment before payment
    • Steam
      • Receive Order
      • Accept Payment (User)
      • Cancel Payment
      • Refund Payment
      • Partial Refund Payment
      • Illegal Payment
      • Order Fraud
      • Chargeback Fraud
      • Payment Cancellation Failed
  • Total Payment Amount: Total Payment Amount: Sum of all search conditions excluding non-progress
  • Number of Purchases Completed: Purchase Completed Counts: Number of completed payments excluding cancellations
  • Total Cancellation Amount/Cancellations: Total Cancellation Amount/Cancellation Counts: Total amount and number of canceled cases
  • Product price: Product price in the display currency set in Price Tier
  • Game_Payload_info: The value received from the game server to be used as an additional indicator in Hive Analytics through the item payment result transmission API
  • IAP_Payload: Purchase metadata self-defined by the app developer
  • Cautions
    • The payment history on the console with the setting value from before the change cannot be canceled if you modify the option value in the PG company configuration.
      • Example 1: The existing Xsolla payment data cannot be canceled in Hive Console if you switch from using Xsolla to PortOnein the PG company settings.
      • Example 2: Payment history from the time a tier code was used cannot be canceled in the Hive Console if the tier code was used and then erased in the PG company settings.
    • If you directly cancel the payment details in the I’mport console, depending on the PG company, the cancellation details may not be delivered to the Hive console so please try to cancel through the Hive panel instead.

PC Payment Item Re-processing

In this menu, you can check the details of the PG payments that are not completed normally. Click Resend to complete the payment process and pay the purchased product. If the retransmission is successful, it will disappear from the search results.

  • Menu Location: Console > Billing > IAP v4 > PG payment completion unprocessed history