@capgo/native-purchases

概要

@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

メソッド	説明
restorePurchases	ユーザーの以前の購入を復元し、それらの購入を利用している他のユーザーの appUserIDs と紐付けます。
getAppTransaction	App Transaction 情報を取得します。ユーザーが最初にアプリをダウンロードまたは購入した時期に関する詳細が含まれます。
isEntitledToOldBusinessModel	App Transaction の元のアプリバージョンとターゲットバージョンを比較し、ユーザーが以前のビジネスモデルの機能を利用する資格があるかを判定します。
purchaseProduct	ネイティブの購入フローを開始します。サポートされている iOS バージョンでは、次を渡します： billingPlanType: 'monthly' 12か月契約の月額課金プランを購入するには
getProducts	製品識別子に関連付けられた製品情報を取得します。サポートされている iOS バージョンでは、サブスクリプション製品に次を含められます： pricingTerms.
getProduct	単一の製品識別子の製品情報を取得します。
isBillingSupported	現在のデバイスで課金がサポートされているか確認します。
getPluginVersion	ネイティブの Capacitor プラグインのバージョンを取得します。
getPurchases	ユーザーのすべての購入（アプリ内課金とサブスクリプションの両方）を取得します。このメソッドは、現在のユーザーのプラットフォームの購入履歴を照会します。
manageSubscriptions	プラットフォームのネイティブなサブスクリプション管理ページを開きます。これにより、ユーザーはサブスクリプションを確認、変更、解約できます。
acknowledgePurchase	購入トランザクションを手動で承認/完了します。
consumePurchase	Androidでアプリ内課金を消費（consume）します。
addListener	AppleのTransaction.updatesから配信されるStoreKitのトランザクション更新をリッスンします。未完了のトランザクションがある場合はアプリ起動時に、その後は更新があるたびに発火します。iOSのみ。
addListener	AppleのTransaction.updatesから配信されるStoreKitのトランザクション検証失敗をリッスンします。検証結果が未検証（unverified）の場合に発火します。iOSのみ。
removeAllListeners	登録されているすべてのリスナーを削除します。

Source of Truth

このリファレンスは以下から同期されています： src/definitions.ts における capacitor-native-purchases.

@capgo/native-purchases から続ける

使用している場合 @capgo/native-purchases 支払いや購入を計画するには、これを以下と連携させます @capgo/native-purchases を使用する 「Using @capgo/native-purchases」のネイティブ機能については、 Capgo の料金 Capgo の料金ページのプロダクトワークフローについては、 決済システム 決済システムの実装詳細については、 スタートガイド 実装の詳細については Getting Started を、 収益化プレイブック 実装の詳細については Revenue Playbook を参照してください。