IAP v4 传输商品配送结果

传输物品交付结果将物品交付的结果发送给通过 IAP v4 购买物品的用户。如果实现此 API,IAP 系统会传输物品交付的状态,该状态在 市场作废购买列表 中是必需的,以限制滥用退款政策的用户。

  • 请求 URL
    公共 URL https://hiveiap.qpyou.cn/api_v4/item_result
    沙盒 URL https://sandbox-hiveiap.qpyou.cn/api_v4/item_result
    HTTP 方法 POST
    内容类型 text/HTML;charset=utf-8
    数据格式 JSON
字段 类型 描述 必填
hiveiap_transaction_id 字符串 发送由 IAP v4 收据验证 响应的 hiveiap_transaction_id 的值 Y
result_status 整数 项目交付是否成功
0: 交付失败
1: 交付成功
Y
user_id_type 字符串 Hive SDK 用户类型
v0: C2S 模块 (uid)
v1: Auth v1 (vid)
v4: Auth v4 (player_id)
Y
user_id 字符串 用户 ID
如果 user_id_type 是 v0,发送 uid;如果 v1,发送 vid;如果 v4,发送 player_id
Y
asset 数组 交付的项目数据
发送交付成功的值,交付失败时响应一个空数组 ([])
N
asset_id 字符串 项目 ID N
asset_name 字符串 项目名称 N
quantity 整数 交付项目的数量 N
game_payload_info 对象 从游戏服务器接收的值,用作 Hibe Analytics 的附加索引 N
  • 示例代码
    • 呼叫
      curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "v4", "user_id": 30000041527, "asset ": [ {"asset_id":"item_1","asset_name":"item_1_name","quantity":1},{"asset_id":"item_2","asset_name":"item_2_name","quantity":1} ], "game_payload_info": {"gifteeid":null,"chracter_type_id":0,"product_name":"Cookingdom Alternative Store Pack 1"}}' -H "Content-Type: text/html" https://sandbox -hiveiap.qpyou.cn/api_v4/item_result
      
    • 请求
       POST /api_v4/item_result HTTP/2
      > Host: sandbox-hiveiap.qpyou.cn
      > user-agent: curl/7.68.0
      > accept: /
      > content-type: text/html
      > content-length: 235
      
    • 响应
      < HTTP/2 200
      < server: nginx
      < date: Wed, 23 Mar 2022 08:20:44 GMT
      < content-type: text/html; charset=utf-8
      {"result":0,"result_msg":"success"}