跳转至

IAP v4 传输商品配送结果

物品交付结果传输API是通过Hive IAP v4向购买消耗品的用户发送物品交付结果的API。

实现物品交付结果传输API调用后，可在Hive控制台结算 > 市场取消·退款查询 > 取消·退款查询菜单中确认物品交付状况。物品交付状况可作为判断哪些用户是滥用用户的依据。

Note

网页PG支付时，必须调用物品交付结果传输API才能完成购买交易处理。

请求信息

项目 说明
商业网址 https://hiveiap.qpyou.cn/v2/api/item_result
沙盒网址 https://sandbox-hiveiap.qpyou.cn/v2/api/item_result
HTTP 方法 POST
数据格式 JSON

HTTP 标头

项目 说明
Content-Type application/json;charset=utf-8
X-Access-Token 用于应用服务器认证的 OAuth 2.0 Access Token
（请参阅 发行 OAuth Token）
认证方式 仅当Hive控制台应用中心 > 项目管理 > 游戏列表 - 选择游戏公司的游戏 > 游戏详情 > 基本信息中Hive认证状态为Y时，才能使用Bearer令牌。
Bearer令牌位置 对应于应用中心 > 项目管理 > 游戏列表 - 选择游戏公司的游戏 > 游戏详情 > 基本信息中的Hive认证密钥。

请求正文

字段 类型 描述 是否必需
hiveiap_transaction_id 字符串 发送从 Hive IAP v4 收据验证 返回的 hiveiap_transaction_id 值 Y
result_status 整数 项目是否成功授予
0: 授予失败
1: 授予成功		 Y
user_id_type 字符串 Hive 用户类型（使用固定值 player_id） Y
user_id 字符串 Hive 用户 ID (player_id) Y
asset 数组 有关授予项目的信息
仅在授予成功时发送值，当授予失败时响应空数组 ([])		 N
asset_id 字符串 项目 ID N
asset_name 字符串 项目名称 N
quantity 整数 授予项目的数量 N
game_payload_info 对象 从游戏服务器接收的值，用于 Hive 分析中的额外指标 N

示例代码

请求

curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "player_id", "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":"쿠킹덤 대체 상점팩 1"}}' -H "Content-Type: application/json" -H "X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog" https://sandbox-hiveiap.qpyou.cn/v2/api/item_result

> POST /v2/api/item_result HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: /
> content-type: application/json
> X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog
> content-length: 235

响应

< HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 08:20:44 GMT
< content-type: application/json; charset=utf-8
{"result":0,"result_msg":"success"}