콘텐츠로 이동

결제

Hive Axyl은 결제 제공자를 통한 인앱 결제 기능을 제공합니다. 단건 결제, 복수 결제, 구독 결제를 지원하며 네트워크 오류 등으로 결제가 완료되었음에도 불구하고 미지급된 상품을 찾아 지급하는 구매 복구 기능도 제공합니다.

Hive Axyl SDK 결제 모듈을 설치 결제 제공자별 기능

Hive Axyl 결제 SDK를 구성하는 메인 결제 모듈 com.com2usplatform.hiveaxyl.payments와 스토어별 결제 플러그인인 Apple(StoreKit 2), Google(Google Play Billing Library 9), Steam(Steamworks MicroTxn), 그리고 메인 결제 모듈과 통신하는 Hive Axyl 서버를 나타낸 그림입니다.

Hive Axyl의 역할과 앱의 역할

  • Hive Axyl이 제공하는 기능

    인앱 결제를 구현하는 과정에서 Hive Axyl이 제공하는 기능은 다음과 같습니다.

    • 단건 결제, 복수 결제, 구독 결제와 결제 제공자별 지원 기능
    • 결제 사전 정보 저장과 결제 결과 기록
    • 영수증 검증과 구매 복구
    • 구매 내역 조회

  • 앱에서 직접 처리해야 하는 작업

    Hive Axyl과 상관없이 앱에서 직접 처리해야 하는 작업은 일반적으로 다음과 같습니다.

    • 인앱 상점 UI 구현
    • 앱 서버에서 Hive Axyl Server API로 영수증 검증 요청
    • 결제 결과와 결제 상태를 앱 UI에 반영
    • 상품을 사용자에게 지급, 환불 또는 취소 시 상품을 사용자로부터 회수, 고객 문의 대응
    • 구매 내역, 취소·환불 내역에 따른 고객 대응

결제 모듈과 결제 플러그인의 관계

Hive Axyl 결제 SDK는 메인 결제 모듈인 com.com2usplatform.hiveaxyl.payments와 스토어별 결제 플러그인 Add-on으로 구성됩니다.

구분 패키지 역할
메인 결제 모듈 com.com2usplatform.hiveaxyl.payments Hive Axyl 서버와 통신하여 결제 흐름의 핵심 로직인 사전 정보 저장, 결제 결과 기록, 결제 확정, 상품 지급 결과 기록을 처리합니다. 모든 플랫폼에서 공통으로 사용합니다.
Apple 결제 플러그인 com.com2usplatform.hiveaxyl.payments.addon.apple iOS/macOS에서 StoreKit 2 네이티브 작업(스토어 상품 조회, 결제창 표시, 트랜잭션 완료 등)을 수행합니다.
Google 결제 플러그인 com.com2usplatform.hiveaxyl.payments.addon.google Android에서 Google Play Billing Library 9 네이티브 작업(BillingClient 연결, 결제 UI 표시, 소비/확인 등)을 수행합니다.
Steam 결제 플러그인 com.com2usplatform.hiveaxyl.payments.addon.steam Windows/macOS에서 Steamworks MicroTxn 콜백을 수신합니다.

결제 플러그인은 다음 원칙으로 사용합니다.

  • 결제 플러그인은 메인 결제 모듈을 대체하지 않습니다. 결제 흐름의 핵심 로직은 항상 메인 결제 모듈이 담당합니다.
  • 결제 플러그인은 앱 개발자가 스토어 전용으로 직접 작성해야 하는 네이티브 코드 영역을 줄입니다. StoreKit, BillingClient, Steamworks 같은 스토어 네이티브 SDK를 직접 호출해야 하는 작업을 대신 처리합니다.
  • 메인 결제 모듈이 이미 제공하는 기능에는 플러그인 코드를 사용하지 마세요. 플러그인은 메인 결제 모듈이 수행할 수 없는 네이티브 스토어 작업에만 사용합니다.

결제 제공자

Hive Axyl이 지원하는 결제 제공자는 크게 두 가지입니다.

  1. 스토어

    • Google Play
    • Apple App Store
    • Steam

  2. PG (Payment Gateway)

    • PortOne, Xsolla, MyCard 등 Hive Axyl이 지원하는 다양한 외부 결제 수단

제공 기능

Hive Axyl은 결제와 관련해 아래 기능을 제공합니다.

결제

Hive Axyl이 제공하는 결제 유형은 다음과 같습니다.

  • 단건 결제

    한 번의 결제 요청으로 사용자가 하나의 상품을 구매하는 기능입니다.

  • 복수 결제

    한 번의 결제 요청으로 사용자가 같은 상품을 여러 개 동시에 구매하는 기능입니다. 예를 들어 상점에서 상품을 100개씩 묶어 판매할 때 500개가 필요하다면, 구매 수량을 5로 설정해 구매합니다. 단, Apple App Store와 Steam은 플랫폼 정책상 이 기능을 지원하지 않습니다.

  • 구독 결제

    한 번의 결제 요청으로 일정 기간 동안 상품 또는 서비스를 이용하는 권한을 제공하는 기능입니다. 자동 갱신 구독 기능을 제공합니다.

    • 자동 갱신 구독
      • 일정 주기별 자동 구독 갱신 기능
      • Google Play 지원 주기: 주간, 1개월, 3개월, 6개월, 연간
      • App Store 지원 주기: 주간, 1개월, 2개월, 3개월, 6개월, 연간
      • PG, Steam 미지원

  • 결제 제공자별 기능

    결제 제공자별로 지원하는 결제 유형이 다릅니다. 아래 표에서 각 결제 제공자가 지원하는 결제 유형을 확인 후 결제를 구현하세요.

    기능 Google Play App Store PG Steam
    단건 결제 O O O O
    복수 결제 O X O X
    구독 결제 O O X X
    자동 갱신 주기 주간, 1/3/6개월, 연간 주간, 1/2/3/6개월, 연간 X X

구매 복구

사용자가 결제를 완료했지만 네트워크 오류 등으로 상품을 받지 못하는 경우가 있습니다. Hive Axyl은 이런 상황에서 영수증을 다시 확인해 미지급 상품을 지급하는 구매 복구 기능을 제공합니다. 앱을 실행하거나 결제 실패 후 재시도할 때 구매 복구를 실행하면 미지급 거래를 찾아 상품 지급을 다시 시도합니다.

영수증 검증

어떤 사용자가 상품을 구매했을 때 앱 클라이언트는 스토어 또는 PG 결제 제공자로부터 "결제 영수증"을 받습니다. Hive Axyl은 이 영수증에 위조나 변조가 있거나 영수증이 중복인지 검사하여 영수증을 검증하는 기능을 제공합니다.

영수증 검증은 앱 서버가 Hive Axyl Server API를 호출해 요청합니다. 앱 클라이언트가 받은 영수증을 앱 서버에 전달하면, 앱 서버는 앱 클라이언트를 거치지 않고 Hive Axyl 서버에서 검증 결과를 직접 받아 확인한 뒤 상품을 지급합니다.

다음 단계

Hive Axyl SDK 결제 모듈을 설치합니다.