IAP v4 아이템 지급 결과 전송

아이템 지급 결과 전송 API는 Hive IAP v4를 통해 소모성 상품을 구매한 유저에게 아이템을 지급한 결과를 전송하는 API입니다. 이 API를 구현하면, 마켓 환불·취소 목록에서 환불 어뷰징 유저 제재에 필수적인 아이템 지급 여부를 Hive IAP 시스템이 대신 전송합니다.

  • Request URL
상용 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
필드 타입 설명 필수
hiveiap_transaction_id String Hive IAP v4 영수증 검증에서 응답한 hiveiap_transaction_id 값을 전송 Y
result_status Integer 아이템 지급 성공여부
0: 지급 실패
1: 지급 성공		 Y
user_id_type String Hive 유저 타입
v0: 개별모듈(uid)
v1: 인증v1(vid)
v4: 인증v4(player_id)		 Y
user_id String 유저 ID
user_id_type이 v0이면 uid, v1이면 vid, v4면 player_id를 전송		 Y
asset Array 지급한 아이템 정보
지급 성공일 때만 값을 전달하고, 지급 실패일 때는 빈 array([])로 응답		 N
asset_id String 아이템 ID N
asset_name String 아이템 이름 N
quantity Integer 지급한 아이템 개수 N
game_payload_info Object Hive 애널리틱스에서 추가 지표로 활용하기 위해 게임 서버로부터 전달 받는 값 N

  • 예제 코드

    • 호출
    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":"쿠킹덤 대체 상점팩 1"}}' -H "Content-Type: text/html" 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: text/html
> content-length: 235
    • 응답
    < 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"}