아이템 지급 결과 전송 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
  • 예제 코드
    • 호출
    • 요청
    • 응답