IAP v4 transmitting Item delivery result

The item delivery result transmission API is an API that sends the result of item delivery to users who have purchased consumable goods through Hive IAP v4. By implementing this API, the Hive IAP system will send the item delivery status, which is essential for sanctioning refund abusing users, on behalf of the market refund and cancellation list.

Request URL¶

Commercial URL	https://hiveiap.qpyou.cn/api_v4/item_result
Sandbox URL	https://sandbox-hiveiap.qpyou.cn/api_v4/item_result
HTTP Method	POST
Content-Type	text/HTML;charset=utf-8
Data Format	JSON

Field		Type	Description	Required
hiveiap_transaction_id		String	Send the hiveiap_transaction_id value returned from Hive IAP v4 receipt verification	Y
result_status		Integer	Whether the item was successfully granted 0: Grant failed 1: Grant successful	Y
user_id_type		String	Hive user type (use fixed value `player_id`)	Y
user_id		String	Hive user ID (`player_id`)	Y
asset		Array	Information about the granted item Only send values when the grant is successful, and respond with an empty array ([]) when the grant fails	N
	asset_id	String	Item ID	N
	asset_name	String	Item name	N
	quantity	Integer	Number of granted items	N
game_payload_info		Object	Values received from the game server for additional metrics in Hive Analytics	N

Example code¶

Call¶

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":"Cooking Kingdom Alternative Store Pack 1"}}' -H "Content-Type: text/html" https://sandbox-hiveiap.qpyou.cn/api_v4/item_result

Request¶

> 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

Response¶

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