网页商店购买限制验证

Hive 控制台 > 社区 & 网页商店 > 网页商店 > 商品管理 可为网页商店商品设置账号购买限制与购买数量限制，并为两项设置各自配置最大购买数量。

网页商店购买限制验证用于检查网页商店中已支付的商品是否超出上述两项设置的最大购买数量。为此提供网页商店支付信息验证 API。

概述¶

包含调用 网页商店支付信息验证 API 在内的网页商店购买限制验证整体流程如下：

1. 开发者：参考PG 支付实现与PG 设置，构建用户在网页商店通过 PG 支付后发放商品的流程。
2. 开发者：当用户在网页商店购买具有账号购买限制或购买数量限制的商品时，在发放商品前调用网页商店支付信息验证 API。
3. Hive 服务器：验证该订单是否超出商品最大购买数量。验证结果作为 API 响应返回给开发者服务器。
4. 开发者：仅在验证条件（如未超出最大购买数量）通过时发放商品。若订单超出最大购买数量，则不发放商品并执行支付取消。网页商店仅在验证结果无问题时才会将数量计入已售并减少剩余数量。若 API 响应判定为无效支付，服务器不得向用户发放商品，且必须执行支付取消。

网页商店支付信息验证 API¶

基于已完成的网页 PG 支付信息，验证支付是否有效，包括是否超出商品最大购买数量。

Request information¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY

Request body¶

Request body sample¶

{
    "type": "paid",
    "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
    "order_id" : "H3175513391360875943",
    "server_id" : "1",
    "appid" : "com.com2us.hivesdk.windows.hivepc", 
    "cs_code" : "20000023100", 
    "paid_datetime": "2025-08-14 10:12:18",
    "quantity": "10",
    "iap_payload": "{\"cs_code\":20000023100,\"data\":{\"server_id\":\"1\",\"server_name\":\"Server 1\",\"channels\":{\"channel_id\":\"11\",\"channel_name\":\"Channel 11\",\"characters\":{\"character_id\":\"111\",\"character_name\":\"Character 111\"}}}}",
}

Response body¶

• 仅对 100, 101 响应进行正常发放。
• 3001 表示该订单已完成验证。仅在尚未发放商品时再次发放。
• 3002 表示超过商品最大购买数量。必须执行支付取消。 详情参阅发放结果处理。

Response body sample¶

{
    "code": 100,
    "msg": "success"
}

Response codes¶

以下是响应代码(code)说明。