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"}