콘텐츠로 이동

Guide Changes Notice

[API 가이드] 사용자 정의 금액 결제 기능 지원

PG 결제 API에서 할인 기능을 사용자 정의 금액 결제 기능으로 변경했습니다. "할인 쿠폰" 용어를 "비율 할인 쿠폰"으로 변경했습니다.

  1. API 요청/응답에서 discount_type → price_type 변경
  2. 웹 PG 결제 API 매개변수 구조 업데이트
  3. 사용자 정의 금액 결제 시 필수 보안 검증 로직 구현

주요 변경 사항

1. 필드명 변경

  • discount_type → price_type
  • 값: none: 일반 금액 결제, custom_price: 사용자 정의 금액 결제

2. 웹 PG 결제 API 매개변수 변경

제거한 매개변수: discount_type, discount_price, total_price, coupon, point 추가한 매개변수: custom_price, discount_coupon

3. 사용자 정의 금액 결제 시 결제 검증

사용자 정의 금액 결제 시 gameserver_price_verify_key를 통한 금액/통화 검증을 해야합니다.

변경한 가이드

[API 가이드] 웹 로그인 > 시작하기 개선

웹 로그인은 하이브 인증에서 제공하는 서비스 중의 하나로, SDK를 연동하지 않고 필요한 콘솔 설정만 완료하면 하이브 서버로 API를 직접 호출하여 구현할 수 있습니다.

웹 로그인 API 사용을 위한 사전 준비 및 사용 방법을 안내하도록, 기존의 콘솔 가이드 > 인증 > 웹 로그인 가이드를 API 가이드 > 웹 로그인 통합 > 시작하기 가이드로 통합하여 개선합니다.

[API 가이드] 할인 쿠폰 검증 API 추가 및 그 외 업데이트

Hive 서버 빌링 API를 업데이트합니다.

주요 업데이트

  1. PG 결제
    • 각 API 응답값에 discount_type, gameserver_price_verify_key 등 할인 관련 파라미터 추가
  2. 웹 PG 결제
    • 상품 목록 조회 API 요청 파라미터 수정, window.addEventListener 스크립트 삭제
    • 상품 주문 요청 API 요청 파라미터 수정, window.addEventListener 스크립트 추가
    • 각 API 응답값에 discount_type, gameserver_price_verify_key 등 할인 관련 파라미터 추가
    • 환불 유저 재결제 대상 환불 내역 조회 API 설명에 할인 관련 안내 추가
  3. 할인 쿠폰 검증 API 추가
    • 사용자가 입력한 쿠폰의 유효성을 검증
    • 유효한 쿠폰에 대한 할인율 정보 반환
    • 결제 전 쿠폰 검증 용도로 사용 (실제 쿠폰 사용은 결제 완료 시 진행)
  4. 영수증 검증 API
    • API 응답값에 파라미터 추가