IAP v4 transmitting Item delivery result

Transmitting Item Delivery Result sends the outcome of item delivery to users who purchased items through IAP v4. If implementing this API, 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 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 SDK 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 Hibe Analytics N
  • Sample code
    • Call 
      curl -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 
       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"}