시작하기
SubX를 사용하여 앱 구독 결제를 구현하는 과정을 단계별로 안내합니다. 5분이면 기본 설정을 완료할 수 있습니다.
1. 프로젝트 생성
회원가입 후 대시보드에 접속하면 첫 프로젝트를 생성하라는 안내가 표시됩니다. 프로젝트는 하나의 앱(또는 서비스)에 대응하는 최상위 단위입니다.
프로젝트를 생성한 뒤 앱을 등록하세요.
- iOS iOS 앱: Apple Bundle ID (예: com.example.myapp)를 입력합니다.
- Android Android 앱: Google Play 패키지 이름을 입력합니다.
앱 등록은 대시보드 사이드바의 앱 메뉴에서 진행합니다.
2. 스토어 연동
앱을 등록했다면, Apple App Store 또는 Google Play Store와 SubX를 연결해야 합니다. 이 단계에서 스토어의 API 키를 발급받고, SubX의 알림 URL을 스토어에 등록합니다.
상세 가이드: 스토어 연동에서 App Store Connect / Google Play Console에서 키를 발급받고 SubX에 입력하는 전체 과정을 스크린샷과 함께 안내합니다.
3. 스토어 상품 등록
Apple App Store Connect 또는 Google Play Console에서 인앱 상품을 먼저 생성한 뒤, SubX 대시보드의 상품 메뉴에서 동일한 식별자로 Product를 등록합니다.
{
"identifier": "com.example.pro.monthly",
"displayName": "Pro 월간 구독",
"appId": "app_xxxx",
"storeProductId": "com.example.pro.monthly"
}4. Entitlement 설정
Entitlement은 사용자에게 부여할 기능 권한입니다. 예를 들어 pro 엔타이틀먼트를 만들고, 월간/연간 구독 Product를 모두 연결하면 어떤 플랜으로 결제해도 동일한 Pro 기능을 이용할 수 있습니다.
// Entitlement 생성
POST https://api.subx.dev/v1/projects/{id}/entitlements
{
"lookupKey": "pro",
"displayName": "Pro 회원"
}
// Product 연결
POST https://api.subx.dev/v1/projects/{id}/entitlements/{eid}/products
{
"productIds": ["product_monthly_id", "product_annual_id"]
}5. Offering 구성
Offering은 SDK에서 조회하는 상품 묶음 단위입니다. 하나의 Offering 안에 여러 Package를 추가하고, 각 Package에 Product를 연결합니다.
// Offering 생성
POST https://api.subx.dev/v1/projects/{id}/offerings
{
"lookupKey": "default",
"displayName": "기본 오퍼링",
"isCurrent": true
}
// Package 추가 후 Product 연결
POST https://api.subx.dev/v1/projects/{id}/offerings/{oid}/packages
{
"lookupKey": "$rc_monthly",
"displayName": "월간 플랜"
}
POST https://api.subx.dev/v1/projects/{id}/offerings/{oid}/packages/{pid}/products
{
"productIds": ["product_monthly_id"]
}6. API 키 발급
대시보드의 API 키 메뉴에서 키를 발급받습니다.
중요: 중요: API 키는 생성 직후 한 번만 전체 값이 표시됩니다. 반드시 바로 복사해서 안전한 곳에 보관하세요.