跳过内容

頁面/區域: 支援 / 高級支援頁面或底部支援區。角色: 區段或頁面標題。見於: 頁面 support-policy.astro。訊息鍵 `support_policy_troubleshooting_title` (支援政策疑難排解標題)。

原生購買 GitHub 儲存庫

自动续订订阅提供对应用程序内容、服务或高级功能的持续访问。 本指南将帮助您在 Google Play Console 中创建和配置订阅。

订阅将在每个 billing 期间结束时自动续订,直到用户取消。 它们适用于:

  • 高级内容访问
  • 广告免费体验
  • 云存储
  • 持续服务

创建订阅

创建订阅
  1. 前往订阅

    在Google Play控制台中,选择您的应用程序,并选择 收入> 订阅 从左侧菜单.

    点击 创建订阅 按钮开始.

    前往订阅

  2. 填写基本信息

    提供订阅名称和产品ID。产品ID用于在应用中配置,且不可更改。

    填写订阅详细信息

  3. 创建基本计划

    Google Play要求每个订阅至少有一个基本计划。native-purchases插件仅支持一个基本计划,以保持与iOS的兼容性。

    点击 添加基本计划 继续

    创建基本计划

  4. 配置基本计划详细信息

    填写:

    • 基本计划ID:
    • billing period:
    • : :

    :

  5. :

    :

    :

  6. :

    :

    :

  7. 查看区域价格

    查看每个国家的自动转换价格。您可以根据需要调整单独的价格。

    查看价格

  8. 保存配置

    保存您的价格配置。

    保存价格

  9. 激活订阅

    点击 激活 按钮以使您的订阅产品活跃并可供购买。

    激活订阅

重要考虑因素

重要注意事项

基础计划限制

基础计划限制

native-purchases 插件要求每个订阅都有一个基础计划,以确保与 iOS 订阅处理一致。多个基础计划不受支持。

宽限期

宽限期

宽限期允许 Google Play 重试失败的付款,同时保持用户的订阅访问。常见的宽限期是:

  • 月度订阅 3 天
  • 较长订阅 7 天

订阅状态

订阅状态

创建后,订阅将处于“草稿”状态,直到激活。您可以在沙盒模式下测试草稿订阅。

在您的应用程序中使用

应用程序使用指南

创建后,请使用产品 ID 在应用程序中引用订阅:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Load subscription info
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['com.example.premium.monthly'],
productType: PURCHASE_TYPE.SUBS,
});
const product = products[0];
console.log(`${product.title} — ${product.priceString}`);
// Purchase (planIdentifier = Base Plan ID from Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'com.example.premium.monthly',
planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
productType: PURCHASE_TYPE.SUBS,
});
console.log('Transaction ID', transaction.transactionId);
// Later, check purchase state
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const subscription = purchases.find(
(purchase) => purchase.productIdentifier === 'com.example.premium.monthly',
);
if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) {
console.log('Subscription active locally');
// For expiration/cancellation, validate purchaseToken through your backend
}

设置安全的后端收据验证功能

Troubleshooting

订阅未出现在应用程序中:

  • 确认产品 ID 完全匹配
  • 确保订阅已激活
  • 检查您的应用程序是否具有正确的包名
  • 激活后等待 2-3 小时,直到更改传播

基础计划错误:

  • 确保您有一个基础计划
  • 确认所有必填字段已填写
  • 检查账单周期是否有效

定价问题:

  • 确认至少选择一个国家
  • 验证基础价格是否大于允许的最小价格
  • 检查汇率是否可接受

继续从创建 Android 自动续订订阅

标题:继续从创建 Android 自动续订订阅

如果您正在使用 创建 Android 自动续订订阅 以规划商店审批和分发为目的,连接 使用 @capgo/native-purchases 为 @capgo/native-purchases 中的本机能力 使用 @capgo/capacitor-in-app-review 为 @capgo/capacitor-in-app-review 中的实现细节 使用 @capgo/capacitor-in-app-review 为使用@capgo/capacitor内购功能的原生能力 @capgo/capacitor原生市场 为@capgo/capacitor原生市场的实现细节 @capgo/capacitor原生市场 为使用@capgo/capacitor原生市场的原生能力