PG 付款

PG付款可以在PC和移动设备上使用。

PG 付款政策¶

類別	描述
語言	提供 16 種語言 PG 公司提供的付款畫面支持每個 PG 公司的不同語言。
功能	通過外部網頁瀏覽器進行付款的伺服器操作
國家支持	公開 PG 公司所支持的國家
付款方式	必須在控制台中設置合約 PG 公司的付款方式
PG 付款貨幣	hive_country 根據 PG 公司，可能不支持某些貨幣 MyCard: 台灣 (TWD)、香港 (HKD)、馬來西亞 (MYR)、新加坡 (SGD)、泰國 (THB)、印尼 (IDR)、菲律賓 (PHP)、越南 (VND)、全球 (USD)
價格層級	必須上傳到控制台層級用於 PG 付款，並不適用於移動市場註冊 PC 的 App ID 時設置為層級，而不是金額每個遊戲都有自己的層級，創建 PC 的 App ID 時提供基本層級。
產品管理	需要在控制台中註冊產品價格、產品名稱、市場 PID 等
退款用戶償還	與移動市場相同的支持

PG 付款流程¶

① 在遊戲商店中選擇要購買的產品

② 在遊戲畫面外的網頁視圖中顯示付款方式選擇畫面

語言：遊戲語言
貨幣：hive_country，SDK所提供的。如果沒有，則通過IP檢查國家並顯示為該國的貨幣
付款的產品名稱顯示在控制台 > 計費 > IAP v4 > 市場PID管理。如果在要顯示的語言中沒有產品名稱，則顯示輸入的英文產品名稱內容。
付款方式設置可以在控制台 > 計費 > PG付款設置 > PG公司設置中進行

③ 呼叫該國的PG公司付款頁面並在網頁瀏覽器中顯示

當不是付款目標國家時，顯示錯誤頁面

④ 當付款完成時，轉到完成頁面。完成頁面以瀏覽器的語言顯示。

在網路商店中實現PG支付¶

請按照以下步驟建立一個銷售產品的網站。

① 透過前往控制台 > 應用程式中心發佈兩個 AppID。

網頁登錄的 AppID
- 選擇網頁登錄的 AppID
- 選擇用途為網站
- 如果您有已發放的網站用途的 AppID，您也可以使用現有的。
支付的 AppID
- 選擇遊戲 AppID
- 選擇操作系統 – Windows，市場 – 直接分發

② 設定網頁登入的 AppID 詳細資訊。

在登錄信息中輸入所有 IdP 鍵值
設置登錄 IdP 使用
在網絡登錄操作設置中的重定向 URI 中輸入登錄後返回的網站地址

③ 透過前往控制台 > 計費 > 付款環境設置 > PG 公司設置來註冊 PG 公司信息。

④ 在第 1 步中创建的支付 AppID 中注册市场 PID，方法是前往控制台 > 计费 > 应用内支付 > 注册市场 PID。

⑤ 使用網頁登入API和網頁PG支付API開發網站。

預備工作¶

1. PG 付款平台設定¶

使用 PortOne 時
- 在 PortOne 管理控制台註冊 IAP 伺服器回調 URL 並設置 PG 公司
  - 在 PortOne 管理控制台 > 系統設置 > webhook 設定中註冊發送 webhook 的公共 URL
- Webhook URL
  - 商業: https://store.withhive.com/payment/result_processing/import
  - 沙盒: https://sandbox-store.withhive.com/payment/result_processing/import
- 請注意
  - 由於 PortOne 不提供沙盒付款測試，我們建議使用以下方法進行測試。
  - 為商業服務和測試創建兩個 PortOne 帳戶。PortOne 控制台的管理帳戶可以無論實際合同如何創建帳戶。
  - 在 PortOne 商業帳戶上註冊商業 URL，並將實際 PG 公司信息等註冊到實時控制台。
  - 在 PortOne 測試帳戶上註冊沙盒 URL，並將測試 PG 公司信息等註冊到沙盒控制台。
  - 如果僅使用一個實際的 PortOne 帳戶進行商業服務，則在初始申請時連接沙盒，並在正式服務時更改為商業 URL。
  - 在更改為商業 URL 後，請勿更改為沙盒地址。請注意，實際用戶付款將作為測試付款處理。
  - 如果 PortOne 控制台將 PG 公司設置為測試，則交易記錄將在第二天自動取消。商業服務中的遊戲不得設置為測試。
使用 Xsolla 時
- 向平台業務辦公室請求創建子項目並發放項目 ID 和密鑰
通過直接合同使用 MyCard 時
- 通過前往控制台 > PG 公司設置選擇 MyCard 作為服務國家並生成哈希密鑰。
- 在 MyCard 提供的註冊表中輸入控制台發放的哈希密鑰以及付款的 IP、URL 和客戶公司註冊信息，並提交給 MyCard。從下面的附加文件下載 IP 和 URL 信息。下載 IP 和 URL 信息
- 之後，從 MyCard 獲取 FaServiceID 並將其輸入控制台的 PG 公司設置中。
- 請注意
  - 最低和最高付款金額根據每種付款方式的貨幣進行指定，因此在設置產品價格時請小心。
  - 在請求超出適用價格範圍的產品付款時，將顯示錯誤消息。

2. 控制台設定¶

價格層級設定
- 選單位置：控制台 > 計費 > 商店價格管理 > 價格層級
- 價格層級設定指南快捷鍵
註冊市場 PID
- 選單位置：控制台 > 計費 > 應用內購買 > 市場 PID 註冊
- 市場 PID 註冊指南快捷鍵
PG 付款設定
- 選單位置：控制台 > 計費 > 付款環境設定 > PG 公司設定
- PG 公司設定指南快捷鍵

PG 設定指南¶

PG 設定方法¶

您可以根據應用程式 ID 配置 PG 資訊，選項如下：

個別設定¶

為單一應用程式 ID 配置 PG 資訊。
點擊應用程式 ID 的 編輯圖示，或選擇應用程式 ID 並點擊 編輯按鈕 以進入 PG 設定頁面。

批次設定¶

將相同的 PG 資訊一次應用於所有選定的應用程式 ID。
要將相同的 PG 資訊應用於所有選定的應用程式 ID，請選擇所需的應用程式 ID，然後單擊 編輯按鈕。
對於批次配置，現有設置可能在應用程式 ID 之間有所不同，因此無法自動檢索先前的資訊。
如有需要，請單擊 載入現有設置按鈕 從特定的應用程式 ID 匯入 PG 資訊並繼續配置。
一旦保存，當前的 PG 資訊將應用於所有選定的應用程式 ID。

載入現有設定¶

如果您想引用或應用來自另一個應用程式 ID 的 PG 資訊，請使用 載入現有設定 功能。

點擊按鈕並選擇所需的 App ID 後，其 PG 配置將被導入。

加載後，請確保進入每個 PG 平台設置彈出窗口並保存更改。

服務國家選擇¶

您可以選擇每個 PG 平台可用的國家。付款僅會在選定的國家處理。

Note

每個國家只能服務一個支付平台，並且在同一國家不能同時使用多個支付平台。
例如：如果 PortOne 的服務國家設置為「南韓 (KR)」，則 Mycard 或 Xsolla 也不能設置為「南韓 (KR)」。

PG 公司設定¶

PortOne 設定¶

基本信息
- 输入在 PortOne 管理控制台的系统设置中注册的相同信息。
- 如果存在子商店，必须输入层级代码。
- 对于与 Naver Pay 的直接集成，必须输入链 ID 值。

付款方式資訊
- 在 PortOne 管理控制台中設置的 PG 公司列表會自動導入。
- 選擇付款方式時，對於 KCP，您必須檢查 PG ID 並啟用它以匹配 PortOne 管理控制台。
- 如果由 PG ID 啟用的付款方式與 PortOne 管理控制台中的付款方式不同，則可能無法正確顯示。
- 如果 PG 公司合約需要測試付款頁面，您可以複製預覽頁面 URL 並提供給 PG 公司。

MyCard 設定¶

基本信息
- 输入MyCard提供的FacServiceID。
- 点击自动生成按钮以创建认证号码（哈希密钥）。
- 复制生成的认证号码（哈希密钥），将其输入到MyCard注册请求表单中，并提交给MyCard。
- 如果您想使用已注册的认证号码（哈希密钥），请直接输入。
付款方式信息
- 仅支持Mycard作为付款方式。

Xsolla 設定¶

基本信息
- 输入来自 Xsolla 控制台 > 项目设置 > 常规设置的项目 ID 和密钥。
付款方式信息
- 选择要使用的付款方式。
- 选择一个国家以查看按国家支持的付款方式。
- 使用预览提前检查每个国家将显示哪些付款方式。
  - 如果选择一个国家，则仅会在预览中显示该国家支持的已激活付款方式。
  - 如果不选择国家，预览将根据第一个选择的服务国家显示付款方式。

PG 付款通知設定¶

一旦付款成功或被取消，付款信息将发送到输入的 URL。然后，游戏可以使用此结果验证收据并将购买的物品交付给用户。如果没有配置的服务器，则此字段可以留空。在这种情况下，游戏必须直接查询未付款的交易并运行收据验证过程。

付款完成資訊：立即將成功或取消資訊發送到輸入的 URL。
所有付款資訊：立即將所有付款詳細資訊（成功、取消、退款、用戶重新付款）發送到輸入的 URL。

PC 付款查詢與取消¶

在一個頁面上檢查 PortOne 或 Xsolla 的所有付款詳細信息，如有必要可直接取消。 Terminal 3 的 Paymentwall 發送付款取消請求，而不是立即取消付款，是否已完成取消必須在 terminal 3 控制台中確認。

PG 公司和支付方式
- 提供公司提供的所有 PG 的列表作为可选选择，无论支付方式是否在 PG 公司设置中激活。
状态
- PG
  - 支付完成 - 支付已成功完成
  - 支付失败 - 由于支付过程中出现错误等原因导致支付失败。
  - 支付待处理 - 由于账户转账等原因，支付未立即完成。
  - 取消请求 - 请求取消支付
  - 取消完成 - 支付已正确取消。终端 3 的支付无法确认取消是否已完成
  - 取消失败 - 取消请求失败
  - 未完成 - 因用户关闭支付窗口或在支付前点击取消支付而未完成支付
- Steam
  - 接收订单
  - 接受支付（用户）
  - 取消支付
  - 退款支付
  - 部分退款支付
  - 非法支付
  - 订单欺诈
  - 退款欺诈
  - 支付取消失败
总支付金额：总支付金额：所有搜索条件的总和，不包括未进行的支付
完成购买数量：购买完成计数：完成支付的数量，不包括取消的支付
总取消金额/取消数量：总取消金额/取消计数：取消案例的总金额和数量
产品价格：在价格层级中设置的显示货币的产品价格
Game_Payload_info：从游戏服务器接收的值，用作通过项目支付结果传输 API 在分析中使用的附加指标
IAP_Payload：应用开发者自定义的购买元数据
注意事项
- 在更改之前的设置值的控制台上的支付历史记录，如果您在 PG 公司配置中修改选项值，则无法取消。
  - 示例 1：如果您在 PG 公司设置中从使用 Xsolla 切换到 PortOne，则无法在控制台中取消现有的 Xsolla 支付数据。
  - 示例 2：如果在 PG 公司设置中使用了层级代码并随后将其删除，则无法在控制台中取消使用该层级代码时的支付历史记录。
- 如果您直接在 I'mport 控制台中取消支付详情，根据 PG 公司，取消详情可能不会传递到控制台，因此请尝试通过面板进行取消。

PC付款項目重新處理¶

在此菜單中，您可以檢查未正常完成的PG付款的詳細信息。單擊重新發送以完成付款過程並支付所購買的產品。如果重新發送成功，它將從搜索結果中消失。

菜單位置：控制台 > 計費 > IAP v4 > PG付款完成未處理歷史

符合加州數位媒體消費者保護法 (AB 2426)¶

根據加州的“數位媒體消費者保護法（AB 2426）”的執行，必須通知消費者他們實際上並不擁有數位內容的購買權。反映此政策的通知會顯示在PG支付界面中。此消息僅在國家設置為美國且語言設置為英語（en）時顯示。
點擊了解更多將打開在控制台 > 配置 > 服務條款中設置的服務條款鏈接。