개요
“개요” 섹션@capgo/native-purchases 랩핑 StoreKit 2 및 Google Play Billing 구독, 소모품, 복원 플로우를 위한 단일 Capacitor API로 통합합니다. 스토어에서 제품 메타데이터를 로드하고 앱 내에서 구매하며, 별도의 네이티브 브리지를 유지하지 않고 권한을 갱신하세요.
서드파티 구독 SDK 없이 퍼스트파티 빌링을 원할 때 이 플러그인을 선택하세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 빌링 스택 |
|---|---|
| iOS | StoreKit 2 |
| Android | Google Play Billing 7+ 이상 |
핵심 기능
“핵심 기능” 섹션- StoreKit 2와 Google Play Billing을 통한 네이티브 인앱 결제 및 구독.
- 현지화된 상품명과 가격을 포함해 스토어에서 직접 불러오는 상품 메타데이터.
- 12개월 약정 월간 구독에 대한 iOS StoreKit 가격 조건.
- 구매, 복원, 엔타이틀먼트 갱신 및 네이티브 구독 관리 플로우.
- 이전 비즈니스 모델에서 마이그레이션하기 위한 App Transaction 헬퍼.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
restorePurchases | 사용자의 이전 구매를 복원하고, 해당 appUserID를 같은 항목을 사용하는 다른 사용자의 appUserID와 연결합니다. |
getAppTransaction | App Transaction 정보를 가져옵니다. 이 정보는 사용자가 앱을 최초로 다운로드하거나 구매한 시점에 대한 세부 정보를 제공합니다. |
isEntitledToOldBusinessModel | App Transaction의 원래 앱 버전을 대상 버전과 비교하여, 사용자가 이전 비즈니스 모델의 기능을 사용할 권한이 있는지 확인합니다. |
purchaseProduct | 네이티브 구매 플로우를 시작합니다. 지원되는 iOS 버전에서는 billingPlanType: 'monthly' 를 전달하여 12개월 약정 월간 결제 플랜을 구매할 수 있습니다. |
getProducts | 제품 식별자와 관련된 제품 정보를 가져옵니다. 지원되는 iOS 버전에서는 구독 제품에 pricingTerms. |
getProduct | 단일 제품 식별자에 대한 제품 정보를 가져옵니다. |
isBillingSupported | 현재 기기가 결제(billing)를 지원하는지 확인합니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
getPurchases | 사용자의 모든 구매 내역(인앱 구매 및 구독)을 가져옵니다. 이 메서드는 현재 사용자의 플랫폼 구매 이력을 조회합니다. |
manageSubscriptions | 플랫폼의 네이티브 구독 관리 페이지를 엽니다. 사용자는 구독을 확인, 수정 또는 취소할 수 있습니다. |
acknowledgePurchase | 구매 트랜잭션을 수동으로 확인(acknowledge)하거나 완료(finish)합니다. |
consumePurchase | Android에서 인앱 구매를 소모(consume)합니다. |
addListener | Apple의 Transaction.updates를 통해 전달되는 StoreKit 트랜잭션 업데이트를 수신합니다. 미완료 트랜잭션이 있으면 앱 시작 시, 이후에는 업데이트 발생 시마다 트리거됩니다. iOS 전용. |
addListener | Apple의 Transaction.updates를 통해 전달되는 StoreKit 트랜잭션 검증 실패를 수신합니다. 검증 결과가 unverified일 때 트리거됩니다. iOS 전용. |
removeAllListeners | 등록된 모든 리스너를 제거합니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-native-purchases.
@capgo/native-purchases에서 계속하기
“@capgo/native-purchases에서 계속하기” 섹션사용 중이라면 @capgo/native-purchases 결제와 구매를 계획하려면 다음을 연결하세요 @capgo/native-purchases 사용하기 @capgo/native-purchases 사용 시 네이티브 기능을 위해, Capgo 가격 Capgo 가격 페이지의 제품 워크플로우, 결제 시스템 결제 시스템의 구현 상세 내용, 시작하기 구현 세부 사항은 Getting Started에서 확인하고, 수익화 플레이북 구현 세부 사항은 Revenue Playbook을 참고하세요.
