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 IAP. By implementing this API, the 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 | application/json;charset=utf-8 |
| Data Format | JSON |
| Field | Type | Description | Required | |
|---|---|---|---|---|
| hiveiap_transaction_id | String | Send the hiveiap_transaction_id value returned from IAP 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 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: application/json" 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: application/json
> content-length: 235