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