빌링 사용하기¶

IAP v4는 간단하게 결제를 구현할 수 있도록 영수증 검증과 중복지급 체크 및 결제 로그 전송 등의 일련의 과정을 지원하여 개발 시간을 줄이고, 마켓의 변화에 빠르게 대응할 수 있는 결제 모듈입니다.

IAP v4 소개¶

IAP v4는 다음과 같은 특징을 가지고 있습니다.

• Google, Apple, 원스토어, 러비 상점의 빌링 시스템을 하나의 API로 개발할 수 있습니다.
• 상품 정보 요청 시 IAP v4 서버가 통화 표기 및 부가세를 계산하여 게임에 전달합니다.
• 매출 정보 시스템에 등록된 마켓 PID 리스트를 SDK를 통해 전달받을 수 있습니다.
• 게임 클라이언트에서 영수증 검증 요청 시 게임 정보를 함께 전송하면 IAP v4 서버가 결제 로그와 게임 정보를 함께 애널리틱스에 전송합니다.
• 마켓 PID 기준으로 구매 플로우가 진행됩니다.
• pre purchase(구매 클릭 시), purchase(구매 후), post purchase(finish 호출 후) 과정의 로그를 수집하여 구매 상태 및 영수증 검증 과정을 명확히 합니다.
• IAP v4에서는 결제 및 영수증 검증, 로그 전송을 수행하고 아이템 지급은 게임 서버에서 처리해야 합니다.
• Window, 모바일 환경에서 PG 결제를 지원합니다.
• Windows 환경에서는 Steam 마켓 결제를 지원합니다.
• Steam 마켓 결제를 위해 다음 하이브 콘솔 설정이 필요합니다.
  • 마켓 PID 등록
  • Steam 마켓 AppID 입력
  • Steam IAP 키 등록
• Steam 환경을 샌드박스로 설정하면 샌드박스 결제로 진행됩니다.

IAP v4 구매 과정 도식화¶

IAP v4 기능 지원 현황¶

IAP v4 연동 플로우¶

마켓이 여러 개인 경우 연동 플로우¶

앱에서 여러 마켓을 지원하는 경우(예: App Store + Hive Store), 아래 플로우를 참고하여 API를 호출하세요.

flowchart TD
    A(["marketConnect"])
    B(["getProductInfo"])
    C(["setMarketSelection"])
    D(["purchase"])
    E(["영수증 검증 (게임 서버)"])
    F(["transactionFinish"])

    A -- "앱 실행 시 1회" --> B
    B -- "마켓별 최초 1회" --> C
    C -- "구매에 사용할 마켓 지정" --> D
    D --> E --> F