SuperAPI AI 工具集

shopify-billing

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:在 Remix 应用中使用 @shopify/shopify-app-remix(v3.8+)实现 Shopify 应用计费,支持按时间订阅(30 天或年度)、按用量订阅(30 天周期)和一次性购买。官方已弃用 REST 计费 API,需使用 GraphQL Admin API。

主要能力:定义套餐(价格、周期、功能、用量上限);生成 billing 配置;发起订阅请求并处理商户确认回调;查询与强制校验订阅状态;取消订阅(可 prorate);通过 lineItems 覆盖应用优惠券折扣;订阅计费相关 Webhook 监控订阅变更、一次性购买更新与用量接近上限提醒。

使用方式:在 app/config/plans.ts 定义 PLANS;在 shopify.server.ts 生成 billingConfig 并传入 shopifyApp();订阅发起路由调用 authenticate.admin() 与 billing.request(),通过 returnUrl 回跳确认路由;确认路由用 billing.check() 校验 hasActivePayment 后更新数据库;页面用 billing.check()(非阻塞)或 billing.require()(阻塞,失败走 onFailure);取消用 billing.cancel({ subscriptionId, isTest, prorate })。价格、试用天数、优惠券等以项目示例给出:Basic 4.99 美元/30 天、Pro 14.99 美元/30 天、7 天试用、FIRST50 与 WELCOME30 优惠券。

适用场景:Shopify 应用需要收费、套餐升降级、用量计费与优惠券促销时。

限制:订阅须经商户在确认 URL 批准后才生效;每个商户同一应用仅一个有效订阅,新建订阅会替换旧订阅,替换时机由 replacementBehavior 控制(STANDARD、APPLY_IMMEDIATELY、APPLY_ON_NEXT_BILLING_CYCLE);开发环境应用 isTest 测试模式;需处理 APP_SUBSCRIPTIONS_UPDATE 等 Webhook 以同步取消等状态。具体费用、平台支持与政策细节暂未提供。