콘텐츠로 이동

Payments 모듈

인앱 결제를 Hive Axyl 서버에서 처리하는 모듈입니다. 상품 목록 조회, 결제 시도와 결제 결과 저장, 결제 확정, 구매 복구, 소모성 상품 지급 결과 저장, 구독 결제 처리를 제공합니다. 영수증 검증은 이 모듈에서 하지 않고, 앱 서버가 Hive Axyl Server API를 호출해 요청합니다. 자세한 내용은 영수증 검증을 참조하세요.

모듈 정보

  • 패키지: com.com2usplatform.hiveaxyl.payments
  • 네임스페이스: Hive.Axyl.Payments
  • 지원 플랫폼: 전체 (서버 API)
  • 최소 사양: Unity 6000.0+

제공 인터페이스

인터페이스 등록 메서드 설명
IPaymentsService AddPayments() 상품 목록 조회, 결제 기록, 결제 확정, 구매 복구, 지급 결과 저장, 구독 결제

결제 Add-on과의 관계

스토어 SDK를 직접 호출해야 하는 작업은 결제 Add-on이 담당합니다. 스토어 상품 조회, 결제 화면 표시, 스토어 거래 완료, Steam 결제 승인 콜백 수신 같은 작업이 여기에 해당합니다. 결제 기록, 결제 확정처럼 앱 클라이언트가 Hive Axyl 서버에 요청하는 작업은 이 모듈이 담당합니다. Add-on은 이 모듈을 대체하지 않으므로, Add-on이 있는 결제 제공자에서는 아래 Add-on과 이 모듈을 함께 사용합니다.

결제 제공자별 지원 결제 유형과 모듈별 역할은 결제를 참조하세요.

등록과 획득

HiveBootstrap.Initialize의 등록 단계에서 AddPayments()로 등록한 뒤 HiveCore.Resolve<T>()로 가져옵니다.

AddPayments()는 결제 모듈을 운영 서버에 연결합니다. 개발과 테스트 중에는 AddPayments(sandbox: true)로 등록해 샌드박스 서버에 연결하세요. 실제 서비스 빌드에서는 sandbox: true 없이 AddPayments()로 등록하세요.

sandbox: true는 결제 모듈의 연결 서버만 바꿉니다. 함께 등록한 다른 모듈의 연결 서버는 바뀌지 않습니다.

using Hive.Axyl.Core;
using Hive.Axyl.Core.Unity;   // HiveBootstrap
using Hive.Axyl.Payments;

var config = CoreConfig.CreateBuilder("{appId}").Build();

HiveBootstrap.Initialize(config, builder =>
{
    builder.AddPayments(sandbox: true);   // 개발·테스트 환경. 실제 서비스 빌드는 AddPayments()
});

IPaymentsService payments = HiveCore.Resolve<IPaymentsService>();

IPaymentsService의 모든 메서드는 로그인 세션이 필요합니다. 함께 설치할 모듈, 설치 절차, 초기화와 로그인 순서는 모듈 설치, 초기화, 로그인을 참조하세요.