콘텐츠로 이동

1단계. 연동 환경 구성

Apple 콘솔에서 준비한 인증 정보를 Hive 콘솔에 등록하고, 전용 플러그인으로 Apple 결제를 구현할 환경을 구성합니다.

1. 스토어 설정 및 콘솔 설정

Apple 결제를 사용하려면 App Store Connect에서 인증 키를 발급받은 뒤, 해당 정보를 Hive 콘솔에 등록해야 합니다.

1.1. Apple 콘솔 인증 키 발급

App Store Connect에서 결제에 필요한 Private Key, Private Key ID, Issuer ID를 발급받습니다. 자세한 내용은 사전 준비를 참조하세요.

1.2. Hive 콘솔 인증 키 입력

App Store Connect에서 발급받은 Private Key와 Private Key ID, Issuer ID를 Hive 콘솔의 스토어 설정에 등록합니다. 자세한 내용은 App Store 인증 정보를 참조하세요.

2. Hive Axyl Apple 결제 플러그인 설치

Apple App Store 결제를 구현하려면 Hive Axyl Apple 결제 플러그인(com.com2usplatform.hiveaxyl.payments.addon.apple)을 설치하고 초기화 시 등록해야 합니다. 이 플러그인은 iOS 17+ 및 macOS 15+ 환경을 지원합니다.

아래 순서에 따라 플러그인을 설치하고 등록합니다.

2.1. 패키지 설치

  1. Unity 프로젝트에서 Package Manager를 여세요.
  2. com.com2usplatform.hiveaxyl.payments.addon.apple 패키지를 검색하세요.
  3. Install을 눌러 플러그인을 설치하세요.
  4. 설치가 완료되면 Project 창에서 com.com2usplatform.hiveaxyl.payments.addon.apple 패키지가 추가되었는지 확인하세요.

2.2. 플러그인 등록

모듈 설치 및 초기화에서 HiveBootstrap.Initialize를 호출할 때, builder에 AddStoreKit()을 추가로 등록합니다.

using Hive.Axyl.Core;
using Hive.Axyl.Core.Unity;
using Hive.Axyl.Auth;
using Hive.Axyl.Payments;
using Hive.Axyl.Payments.Addon.Apple; // Apple StoreKit 플러그인

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

HiveBootstrap.Initialize(config, builder =>
{
    builder.AddAuth();
    builder.AddToken();
    builder.AddPayments(sandbox: true);  // 개발·테스트 환경. 실제 서비스 빌드는 AddPayments()
    builder.AddStoreKit();  // Apple StoreKit 플러그인 등록
});

등록한 Apple StoreKit 플러그인은 아래와 같이 가져와 사용합니다.

// Apple StoreKit 플러그인 획득
if (HiveCore.TryResolve<IAppleStoreKitPlugin>(out var applePlugin))
{
    // applePlugin을 사용해 Apple App Store 결제 기능 호출
}

3. 선택: Hive 콘솔 상품별 가격 등급 설정

Apple App Store 결제에서는 실제 결제 가격이 App Store에서 관리됩니다. Hive 콘솔에서 입력한 가격 정보는 Hive 콘솔에서 확인하는 용도로만 사용되므로 선택 사항입니다.

가격 등급을 설정하려면 가격 등급을 참조하세요.

4. Hive 콘솔 상품 등록

판매할 상품을 등록하는 방법은 상품 등록을 참조하세요.

Caution

Apple App Store에 등록한 상품과 Hive 콘솔에 등록한 상품의 Product ID는 서로 일치해야 합니다. Apple App Store 콘솔에 입력된 정보를 활용하는 것을 권장합니다.

다음 단계

Apple App Store에 등록된 상품 목록을 조회합니다.