IAP v4 아이템 지급 결과 전송

아이템 지급 결과 전송 API는 Hive IAP v4를 통해 소모성 상품을 구매한 유저에게 아이템을 지급한 결과를 전송하는 API입니다.

아이템 지급 결과 전송 API 호출을 구현하면, 하이브 콘솔 빌링 > 마켓 취소·환불 조회 > 취소·환불 조회에서 아이템 지급 여부 확인이 가능합니다. 아이템 지급 여부는 어떤 유저가 어뷰징 유저인지 아닌지 판단하는 근거로 활용할 수 있습니다.

Note

웹 PG 결제 시 아이템 지급 결과 전송 API를 필수로 호출해야 구매 트랜잭션 처리를 완료할 수 있습니다.

Request 정보¶

항목	설명
상용 URL	https://hiveiap.qpyou.cn/v2/api/item_result
Sandbox URL	https://sandbox-hiveiap.qpyou.cn/v2/api/item_result
HTTP Method	POST
Data Format	JSON

HTTP Header¶

항목	설명
Content-Type	application/json;charset=utf-8
X-Access-Token	앱 서버 인증을 위한 OAuth 2.0 Access Token (OAuth Token 발급하기 참고)

Request Body¶

필드		타입	설명	필수
hiveiap_transaction_id		String	IAP v4 영수증 검증에서 응답한 hiveiap_transaction_id 값을 전송	Y
result_status		Integer	아이템 지급 성공 여부 0: 지급 실패 1: 지급 성공	Y
user_id_type		String	하이브 유저 타입 (`player_id` 고정값 사용)	Y
user_id		String	하이브 유저 ID (`player_id`)	Y
asset		Array	지급한 아이템 정보 지급 성공일 때만 값을 전달하고, 지급 실패일 때는 빈 array([])로 응답	N
	asset_id	String	아이템 ID	N
	asset_name	String	아이템 이름	N
	quantity	Integer	지급한 아이템 개수	N
game_payload_info		Object	애널리틱스에서 추가 지표로 활용하기 위해 게임 서버로부터 전달받는 값	N

예제 코드¶

Request¶

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

Response¶

< 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"}