IAP v4 アイテム配信結果の送信

アイテム支給結果送信APIは、Hive IAP v4を通じて消費財を購入したユーザーにアイテムを支給した結果を送信するAPIです。

アイテム支給結果送信APIコールを実装すると、Hiveコンソールの請求 > マーケットキャンセル・返金照会 > キャンセル・返金照会メニューでアイテム支給状況を確認できます。アイテム支給状況は、アビューズユーザーかどうかを判断する根拠として活用できます。

Note

ウェブPG決済の際は、アイテム支給結果送信APIを必ず呼び出して、購入トランザクション処理を完了させる必要があります。

リクエスト情報¶

項目	説明
商用URL	https://hiveiap.qpyou.cn/v2/api/item_result
サンドボックスURL	https://sandbox-hiveiap.qpyou.cn/v2/api/item_result
HTTPメソッド	POST
データフォーマット	JSON

HTTPヘッダー¶

項目	説明
Content-Type	application/json;charset=utf-8
X-Access-Token	アプリサーバー認証用の OAuth 2.0 Access Token （OAuth Token 発行を参照）
認証方法	Hiveコンソールのアプリセンター > プロジェクト管理 > ゲームリスト - ゲーム会社のゲームを選択 > ゲーム詳細 > 基本情報でHive認証ステータスが`Y`の場合のみ、Bearerトークンを使用できます。
Bearerトークンの場所	アプリセンター > プロジェクト管理 > ゲームリスト - ゲーム会社のゲームを選択 > ゲーム詳細 > 基本情報のHive認証キーに該当します。

リクエストボディ¶

フィールド		タイプ	説明	必須
hiveiap_transaction_id		文字列	Hive IAP v4 レシート検証から返されたhiveiap_transaction_idの値を送信します	Y
result_status		整数	アイテムが正常に付与されたかどうか 0: 付与失敗 1: 付与成功	Y
user_id_type		文字列	Hive ユーザータイプ（固定値`player_id`を使用）	Y
user_id		文字列	Hive ユーザーID（`player_id`）	Y
asset		配列	付与されたアイテムに関する情報付与が成功した場合のみ値を送信し、付与が失敗した場合は空の配列（[]）で応答します	N
	asset_id	文字列	アイテムID	N
	asset_name	文字列	アイテム名	N
	quantity	整数	付与されたアイテムの数	N
game_payload_info		オブジェクト	Hive アナリティクスの追加メトリクスのためにゲームサーバーから受信した値	N

サンプルコード¶

リクエスト¶

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":"쿠킹덤 대체 상점팩 1"}}' -H "Content-Type: application/json" -H "X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog" https://sandbox-hiveiap.qpyou.cn/v2/api/item_result

> POST /v2/api/item_result HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: /
> content-type: application/json
> X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog
> content-length: 235

レスポンス¶

< HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 08:20:44 GMT
< content-type: application/json; charset=utf-8
{"result":0,"result_msg":"success"}