@capgo/native-purchases

概览

@capgo/native-purchases 封装 StoreKit 2 以及 Google Play 结算系统 通过一个 Capacitor API 即可覆盖订阅、消耗型商品和恢复购买流程。从商店加载产品元数据、在应用内购买并刷新权益，无需维护单独的原生桥接。

如果你想要第一方计费，又不想依赖第三方订阅 SDK，就选这个插件。

平台支持

平台	计费技术栈
iOS	StoreKit 2
Android	Google Play Billing 7+

核心功能

• 通过 StoreKit 2 和 Google Play Billing 实现原生应用内购买与订阅。
• 直接从商店加载产品元数据，包括本地化标题和价格。
• 适用于带有 12 个月承诺的月度订阅的 iOS StoreKit 定价条款。
• 包含购买、恢复、权益刷新以及原生订阅管理流程。
• 用于从旧业务模式迁移的 App Transaction 辅助工具。

公开 API

方法	描述
restorePurchases	恢复用户之前的购买记录，并将其 appUserIDs 与任何也使用这些 appUserIDs 的用户关联。
getAppTransaction	获取 App Transaction 信息，其中包含用户最初下载或购买 App 的详细信息。
isEntitledToOldBusinessModel	将 App Transaction 中的原始 App 版本与目标版本进行对比，以确定用户是否有权使用旧版商业模式的功能。
purchaseProduct	启动原生购买流程。在支持的 iOS 版本上，传入 billingPlanType: 'monthly' 用于购买含 12 个月承诺期的按月计费方案。
getProducts	获取与产品标识符关联的产品信息。在支持的 iOS 版本上，订阅产品可包含 pricingTerms.
getProduct	获取单个产品标识符的产品信息。
isBillingSupported	检查当前设备是否支持计费。
getPluginVersion	获取原生 Capacitor 插件版本。
getPurchases	获取用户的所有购买记录（包括应用内购买和订阅）。该方法会查询当前用户在平台上的购买历史。
manageSubscriptions	打开平台的原生订阅管理页面。用户可以通过该页面查看、修改或取消其订阅。
acknowledgePurchase	手动确认/完成一笔购买交易。
consumePurchase	在 Android 上消耗应用内购买项目。
addListener	监听由 Apple Transaction.updates 推送的 StoreKit 交易更新。如果存在未完成的交易，则在应用启动时触发，并在后续有更新时触发。仅限 iOS。
addListener	监听由 Apple Transaction.updates 推送的 StoreKit 交易验证失败事件。当验证结果为未验证时触发。仅限 iOS。
removeAllListeners	移除所有已注册的监听器。

单一事实来源

此参考文档同步自 src/definitions.ts 中的 capacitor-native-purchases.

继续阅读 @capgo/native-purchases

如果你正在使用 @capgo/native-purchases 要规划付款和购买，请将其与 使用 @capgo/native-purchases 关于“使用 @capgo/native-purchases”中的原生能力， Capgo 定价 关于 Capgo 定价中的产品工作流， 支付系统 了解支付系统的实现细节， 快速入门 关于“入门指南”中的实现细节，以及 营收手册 关于“Revenue Playbook”中的实现细节。