付款金額驗證 API

'付款金額驗證' API 支援當使用者想要購買因網店商品折扣或優惠券應用而改變金額的商品時，使用遊戲伺服器發出的驗證金鑰來驗證折扣付款金額。當使用有效驗證金鑰進行付款時，遊戲伺服器最終可以提供商品。

操作流程¶

這解釋了從呼叫'付款金額驗證' API 到最終商品提供的整體處理順序和系統間處理過程。

Hive 網店伺服器和遊戲伺服器之間的操作和資料流程如下：

1. 使用者操作：在 Hive 網店中購買金額變更的商品時，會呼叫'付款金額驗證' API。
2. Hive 網店伺服器：從 Hive 控制台中註冊的驗證金鑰發放目標 URL（遊戲伺服器）請求驗證金鑰。此時，以回調格式傳遞商品 PID、價格資訊、優惠券代碼等。
   • 有關在 Hive 控制台中註冊驗證金鑰發放目標 URL 的過程，請參考下面的前提條件。
3. 遊戲伺服器：驗證接收到的價格資訊後，返回用於付款驗證的驗證金鑰（gameserver_price_verify_key）作為回應。
4. Hive 網店伺服器：透過計費伺服器將從遊戲伺服器接收的驗證金鑰以及商品 PID 和價格資訊等傳遞回遊戲伺服器來執行付款金額驗證。
5. 遊戲伺服器：當計費伺服器完成付款時，驗證接收到的驗證金鑰的有效性，然後提供最終商品。

前提條件¶

要正常呼叫'付款金額驗證' API，遊戲公司必須首先在 Hive 控制台中註冊用於發放驗證金鑰的端點 URL。Hive 網店伺服器可以透過向該 URL 傳遞商品 PID、價格資訊、優惠券代碼等來請求驗證金鑰。

在 Hive 控制台 > 社群 & 網店 > 網店 > 網店設定 > 付款金額驗證 中註冊 API 端點（回調 URL）。

• 回調 URL 格式可以由遊戲公司自由設定
• 其他 API 規範遵循下面的 API 請求配置和 API 回應配置項目

API 呼叫（Hive 網店伺服器 → 遊戲伺服器）¶

這解釋了如何從 Hive 伺服器向遊戲伺服器呼叫'付款金額驗證' API。

Request info¶

• 端點：在 Hive 控制台 > 社群 & 網店 > 網店 > 網店設定 > 付款金額驗證 中設定的端點（回調 URL）
• HTTP 方法：POST

Request header¶

Request body¶

Request body sample¶

{
    "game_index": 1001,
    "cs_code": "20000010000",
    "language": "ko",
    "market_pid": "item01",
    "quantity": 1,
    "original_price": 10000,
    "sale_price": 8000,
    "coupon_price": 1000,
    "final_price": 7000,
    "discount_coupon_code": "SUMMER2025"
}

API 回應（遊戲伺服器 → Hive 網店伺服器）¶

這解釋了作為呼叫'付款金額驗證' API 的結果，從遊戲伺服器發送到 Hive 網店伺服器的回應資訊。

Response body¶

• 資料類型：JSON

• 參數

  名稱	類型	描述
  code	Integer	結果代碼（100：成功）
  gameserver_price_verify_key	String	用於付款驗證的驗證金鑰（成功時必須返回）

Response code¶

• 成功必須以 100 傳遞。
• 成功時，回應中必須包含 gameserver_price_verify_key。

Response sample¶

{
    "code": 100,
    "gameserver_price_verify_key": "a1b2c3d4e5f6g7h8i9j0"
}