[API 가이드] Hive 아이템 연동 및 PG 결제 API 업데이트¶

하이브 서버 빌링 API 가이드를 업데이트합니다.

배경¶

쿠폰 교환소를 통해 아이템이 지급될 때, 앱 서버가 사용된 쿠폰 번호를 직접 수신하여 외부 시스템과의 정산·환불 대응에 활용할 수 있도록 지급/회수 요청 API에 쿠폰 정보 필드를 추가했습니다.

주요 업데이트¶

1. 아이템 연동
   • additionalinfo 필드 설명 변경: 앱에서 사전 설정한 데이터로 아이템 서버를 거쳐 앱 서버로 전달되는 정보임을 명시
   • platformInfo 필드 설명 변경 및 하위 필드 추가
     • coupon_number: 아이템 지급 시 사용된 쿠폰 번호
     • coupon_pno: 아이템 지급 시 사용된 쿠폰의 프로모션 번호
   • hiveiap_market_id 타입을 String에서 Integer로 수정
2. PG 결제
   • hiveiap_market_id 응답 파라미터 타입을 String에서 Integer로 수정
   • 숫자형 파라미터 타입을 Number에서 Integer로 수정: market_id, user_id, result, quantity, result_status
3. 웹 PG 결제
   • 숫자형 파라미터 타입을 Number에서 Integer로 수정: result, market_id, user_id, quantity, result_status