用途:本技能用于指导开发者在 Shopify 应用模板中实现计费功能,实现应用变现。
主要能力:支持周期性订阅与一次性收费。周期性订阅使用 appSubscriptionCreate 变更,可创建如每月套餐的循环扣费,示例中价格为 10.00 USD、周期 EVERY_30_DAYS;一次性购买使用 appPurchaseOneTimeCreate 变更,例如 50.00 USD 的“Concierge Setup”。也可查询当前安装的活跃订阅,用于功能门控。
使用方式:所有计费操作必须使用 GraphQL Admin API,REST 计费 API 已弃用。创建订阅后必须将商家重定向到返回的 confirmationUrl,只有商家确认后收费才会生效。在 Remix / Shopify App Template 中可先调用 authenticate.admin(request),再通过 admin.graphql 发起变更。查询活跃订阅可读取 currentAppInstallation 的 activeSubscriptions,或使用 billing.require 辅助方法,并设置 onFailure 触发 billing.request。
适用场景:需要在 Shopify 应用内设置付费套餐、按周期扣费或收取一次性费用时。
限制与注意事项:开发阶段应始终设置 test: true(或 isTest),测试收费不会真实扣款。需监听 app_subscriptions/update webhook,以实时处理取消或状态变更。资料未提供具体定价策略、费用标准或其他平台限制。