IAP v4 传输项目交付结果

物品交付結果傳送API是透過Hive IAP v4向購買消耗品的用戶發送物品交付結果的API。

實現物品交付結果傳送API呼叫後，可在Hive控制台結算 > 市場取消・退款查詢 > 取消・退款查詢選單中確認物品交付狀況。物品交付狀況可作為判斷哪些用戶是濫用用戶的依據。

Note

網頁PG支付時，必須呼叫物品交付結果傳送API才能完成購買交易處理。

請求資訊¶

項目	說明
商業網址	https://hiveiap.qpyou.cn/api_v4/item_result
沙盒網址	https://sandbox-hiveiap.qpyou.cn/api_v4/item_result
HTTP 方法	POST
資料格式	JSON

HTTP 標頭¶

項目	說明
Content-Type	application/json;charset=utf-8
Authorization	Bearer（選填）
驗證方式	僅當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 "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" 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: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> 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"}