跳转到正文

@capgo/native-purchases

应用内订阅,轻松搞定

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

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

精确的 Android 优惠

传入 offerToken 来自相同的 getProducts() 你显示的结果 purchaseProduct() 对该优惠进行计费。参见 Android 订阅优惠.

可选的计费周期

Product.subscriptionPeriod 是可选的。Android 在预付费优惠中会省略它。使用 product.subscriptionPeriod?.unit.

分期周期

Android 分期付款计划可以包含 subscriptionBillingCycles 来自 Play 的分期付款承诺付款次数。

这些 Android 优惠和产品详情记录于 capacitor-native-purchases#245.

平台计费技术栈
iOSStoreKit 2
AndroidGoogle Play Billing 7+
  • 基于 StoreKit 2 和 Google Play Billing 的原生应用内购买与订阅。
  • 直接从商店加载产品元数据,包括本地化的标题和价格。
  • Android 优惠令牌、可选的订阅周期以及分期付款的计费周期数。参见 Android 订阅优惠.
  • iOS StoreKit 针对 12 个月承诺期的月度订阅定价条款。
  • 购买、恢复、权益刷新以及原生订阅管理流程。
  • 用于从旧商业模式迁移的 App Transaction 辅助功能。
方法描述
restorePurchases恢复用户之前的购买记录,并将其 appUserIDs 与任何也使用这些 appUserIDs 的用户关联。
getAppTransaction获取 App Transaction 信息,其中包含用户最初下载或购买 App 的详细信息。
isEntitledToOldBusinessModel将 App Transaction 中的原始 App 版本与目标版本进行对比,以确定用户是否有权使用旧版商业模式的功能。
purchaseProduct启动原生购买流程。在 Android 上,传入 offerToken 以从 getProducts(),或 planIdentifier 中购买该基础套餐的第一个优惠。在支持的 iOS 版本上,传入 billingPlanType: 'monthly' 用于购买含 12 个月承诺期的按月计费方案。
getProducts获取与产品标识符关联的产品信息。在支持的 iOS 版本上,订阅产品可包含 pricingTerms。在 Android 上,订阅产品可能包含 subscriptionPeriod 以及 subscriptionBillingCycles ,前提是 Play 提供了这些内容。
getProduct获取单个产品标识符的产品信息。
isBillingSupported检查当前设备是否支持计费。
getPluginVersion获取原生 Capacitor 插件版本。
getPurchases获取用户的所有购买记录(包括应用内购买和订阅)。此方法会查询当前用户在平台上的购买历史。
manageSubscriptions打开平台的原生订阅管理页面。用户可以在这里查看、修改或取消订阅。
acknowledgePurchase手动确认/完成购买交易。
consumePurchase在 Android 上消耗应用内购买。
addListener监听由 Apple 的 Transaction.updates 推送的 StoreKit 交易更新。如果存在未完成的交易,应用启动时会触发;之后任何更新也会触发。仅限 iOS。
addListener监听由 Apple 的 Transaction.updates 推送的 StoreKit 交易验证失败。当验证结果为 unverified 时触发。仅限 iOS。
removeAllListeners移除所有已注册的监听器。

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

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