使用 @capgo/native-purchases

轻松实现内购订阅。

安装

bun add @capgo/native-purchases
bunx cap sync

此插件暴露的内容

restorePurchases - 恢复用户的之前购买记录并将其与任何使用相同的 appUserIDs 的用户关联。
getAppTransaction - 获取 App 交易信息，提供有关用户最初下载或购买应用程序的详细信息。
isEntitledToOldBusinessModel - 比较 App 交易中的原始应用程序版本与目标版本，以确定用户是否有权从早期商业模式中获得特征。
getProducts - 加载商店产品元数据，包括支持的 iOS 订阅定价条款。
purchaseProduct - 启动所选产品和计费计划的购买流程。

- 示例用法

`restorePurchases`

- 恢复用户的之前购买记录并将其与使用相同的应用用户 ID 的用户关联。

import { NativePurchases } from '@capgo/native-purchases';

await NativePurchases.restorePurchases();

`getAppTransaction`

- 获取应用交易信息，提供有关用户最初下载或购买应用的详细信息。

import { NativePurchases } from '@capgo/native-purchases';

const { appTransaction } = await NativePurchases.getAppTransaction();

// Check if user downloaded before version 2.0.0 (when subscription was added)
if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {
  // User gets free access - they downloaded before subscriptions
  grantFreeAccess();
}

`isEntitledToOldBusinessModel`

- 比较应用交易中的原始应用版本与目标版本，以确定用户是否有权从较早的商业模式中获得特征。

import { NativePurchases } from '@capgo/native-purchases';

// Check if user downloaded before version 2.0.0/build 42 (when subscription was added)
const result = await NativePurchases.isEntitledToOldBusinessModel({
  targetVersion: '2.0.0',
  targetBuildNumber: '42'
});

if (result.isOlderVersion) {
  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);
  grantFreeAccess();
}

`purchaseProduct`

- 为给定的产品启动购买流程。对于 Android 订阅，传递 Google Play 基础计划 ID 作为 planIdentifier- 对于支持 iOS 的月度订阅，传递 billingPlanType: 'monthly'.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan',
  productType: PURCHASE_TYPE.SUBS,
});

- 在支持的 iOS 版本上，StoreKit 可以通过

- 在您的付费墙上显示这些条款之前购买： pricingTerms- 全面参考

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.yearly'],
  productType: PURCHASE_TYPE.SUBS,
});

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.example.premium.yearly',
);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly price:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });

  console.log('Billing plan:', transaction.billingPlanType);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
}

- __CAPGO_KEEP_0__:

Start the purchase process for the given product. For Android subscriptions, pass the Google Play base plan ID as GitHub. https://github.com/Cap-go/capacitor-native-purchases/
文档：/docs/plugins/native-purchases/
iOS 月度承诺指南：/docs/plugins/native-purchases/ios-monthly-commitment/

继续使用 @capgo/native-purchases

如果您正在使用 使用 @capgo/native-purchases 来规划付款和购买，连接它与 @capgo/native-purchases 查看 @capgo/native-purchases 中的实现细节开始查看开始中实现细节 Capgo 价格为Capgo产品工作流程中的定价支付系统支付系统的实现细节营收手册营收手册的实现细节

原生购买

本地购买教程