网页商店购买限制验证 API¶

“网页商店购买限制验证”用于验证在网页商店支付的商品是否超过最大购买数量。Hive 服务器通过网页商店支付信息验证 API提供此功能。

准备事项¶

调用网页商店支付信息验证 API 前，请在 Hive Console 中设置最大购买数量。在 Hive Console > 社区 & 网页商店 > 网页商店 > 商品管理 中，通过购买数量限制验证设置为网页商店商品设置账号购买限制和购买数量限制，并可分别设置最大购买数量。

运行流程¶

1. 应用：在网页商店进行 PG 支付时，构建由应用服务器发放商品的流程。相关设置请参阅支付通知设置。
2. 应用服务器：用户在网页商店购买购买数量限制商品时，在发放商品前调用网页商店支付信息验证 API。
3. Hive 服务器：验证用户商品订单是否超过该商品最大购买数量，并将结果作为 API 响应值发送给应用服务器。
4. 应用服务器：确认 API 响应值后，仅在通过验证条件时发放商品。如果订单超过最大购买数量，则不发放商品并取消支付。网页商店仅在验证结果无问题时反映为销售完成数量并减少剩余数量。若 API 响应值显示为无效支付，应用服务器不得向用户发放商品，且必须取消支付。

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

Validates whether the payment is valid based on completed Web PG payment information, including whether the product exceeds the maximum purchase quantity.

Request information¶

Request header¶

Request header 示例¶

Content-Type : application/json
X-Access-Token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InByb2plY3RfYWJjMTIzIn0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5leGFtcGxlIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJwcm9qZWN0IiwiaWF0IjoxNzE1NTg0MDAwLCJleHAiOjE3MTU1ODc2MDAsImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoiIiwiaXNfd2hpdGVsaXN0Ijp0cnVlfQ.signature

Request body¶

Request body 示例¶

{
  "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¶

• Products should be granted normally only for result_code responses 100 and 101.
• result_code 3001 is an already validated order. Grant the product only if it was not granted previously.
• result_code 3002 means the product maximum purchase quantity was exceeded. You must cancel the payment for that order. For details, see Grant result processing.

Response body 示例¶

成功¶

{
  "result_code": 100,
  "result_msg": "success",
  "token_validation": {
    "result_code": 0,
    "result_msg": "success"
  }
}

JWT 验证失败¶

{
  "result_code": 2499,
  "result_msg": "JWT validation failed. See token_validation for details.",
  "token_validation": {
    "result_code": 2408,
    "result_msg": "The access token is expired. Please refresh your token."
  }
}

响应代码¶