Skip to content

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