IAP v4 아이템 지급 결과 전송

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

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

Note

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

Request 정보¶

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

HTTP Header¶

항목	설명
Content-Type	application/json;charset=utf-8
Authorization	Bearer (선택사항)
인증 방법	Hive 콘솔 앱센터 > 프로젝트 관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보에서 Hive 인증 상태가 `Y`일 때만 Bearer 토큰을 사용할 수 있습니다.
Bearer 토큰 위치	앱센터 > 프로젝트 관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보에서 Hive 인증키에 해당합니다.

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 "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://sandbox-hiveiap.qpyou.cn/api_v4/item_result

> POST /api_v4/item_result HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: /
> content-type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> 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"}