Transmitting Item Delivery Result sends the outcome of item delivery to users who purchased items through Hive IAP v4. If implementing this API, Hive IAP System transmits the status of item delivery which is required on the Market Voided Purchases Lists to restrict users who abuse the refund policy.
- Request URL
Common 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 value of hiveiap_transaction_id responded by Hive IAP v4 Receipt verification |
Y | |
result_status | Integer | Whether success in item delivery or not 0: Delivery failure 1: Delivery success |
Y | |
user_id_type | String | Hive user type v0: C2S module (uid) v1: Auth v1 (vid) v4: Auth v4 (player_id) |
Y | |
user_id | String | User ID If user_id_type is v0, send uid; if v1, send vid; if v4, send player_id |
Y | |
asset | Array | The delievered item data Send the value with delivery success, and an empty array ([]) response with delivery failure |
N | |
asset_id | String | Item ID | N | |
asset_name | String | Item name | N | |
quantity | Integer | The number of delivered item | N | |
game_payload_info | Object | The received values from game server to use as an additional index of Hive Analytics | N |
- Sample code
- Call
123curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "v4", "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":"Cookingdom Alternative Store Pack 1"}}' -H "Content-Type: text/html" https://sandbox -hiveiap.qpyou.cn/api_v4/item_result
- Request
1234567> 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
123456< 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"}
- Call