Nuxt Starter

支付

按身份选收款渠道;当前代码只接了 Creem 的订阅结账、Webhook 和测试模式。

模板现在只实现了 Creem。正式收款开哪一家,按你手里的身份来;已经接上的 Creem 留着做兜底,不要因为换了主渠道就整段拆掉。

按身份开户

你有什么 优先开
中国大陆个人,身份证 PayPal 中国 个人卖家,或 Waffo Pancake
香港银行卡,身份用护照 Stripe 个人账户,地区选香港
公司主体 自己开 Stripe,或通过 Subotiz 接入

2026-10-21 核对过的材料要求:PayPal 中国个人卖家要上传大陆身份证正反面并做人脸;Waffo 的身份验证写明中国大陆用 18 位身份证号,其它国籍用护照。Stripe 写明,居住地和账户所在国家不一致时,身份验证要用护照。审核能不能过,以提交当时的结果为准。

Waffo 如果走哥飞的邀请码,群里说有 1000 美元免手续费。同一天在 Waffo 公开的定价页和 Builder 计划 上没看到这条,公开活动写的是按贡献兑换额度,最高 500 美元流水的手续费全免。邀请码当时给多少,以注册页为准。

Subotiz 的收款条款里,卡支付由 Stripe 处理:美国商户对应 Stripe LLC,香港对应 Stripe Payments Europe。另一种是 Merchant of Record,由 Subotiz 作为登记商户收款,再按周期结算。

一个站一个商户

不管用哪家,每个网站单独开一个商户、一个 account。几个站共用同一个商户,会被当成 AB 站,一个站出问题会连累其它站。复制新产品时也要新开,见复制成新产品。

至少接两个渠道,一个被风控时还能切到另一个。正式模式里不要用自己的银行卡试付,用各家的沙箱或测试模式。Creem 的测试卡见下文。

渠道怎么切换

群里的做法是用环境变量 PAY_PROVIDER:Stripe 优先,Creem 兜底。风控一变,改这个变量,不用为了换渠道发一版代码。

模板里这个变量还没接。现在只有 Creem,NUXT_CREEM_API_KEY 和 NUXT_CREEM_WEBHOOK_SECRET 都填了才启用,装配在 server/utils/billing.ts。再加一家时,按 server/billing/provider.ts 的三个方法新写一个实现,由 PAY_PROVIDER 选择。页面和 Webhook 接口不用改。

Creem 是 Merchant of Record:付款页、税务、退订都由它托管,本站只记录订阅状态。

Creem 变量

变量 说明
NUXT_CREEM_API_KEY、NUXT_CREEM_WEBHOOK_SECRET 两项都填才启用支付,否则定价页按钮只去注册
NUXT_CREEM_MODE test(默认)或 live;只有写 live 才真实扣款,其它值一律按测试
NUXT_CREEM_PRODUCTS_PRO、NUXT_CREEM_PRODUCTS_STUDIO 套餐对应的 Creem 商品 ID,键名对应 shared/plans.ts 的 id

测试和正式环境的 Key、商品、Webhook 各是一套,不通用。本地填 .env(Workers 预览填 .dev.vars),线上用 wrangler secret,见部署。

Creem 后台

  1. 左下角打开 Test Mode
  2. Products:为每个付费套餐建一个按月订阅的商品,价格与 shared/plans.ts 一致,复制 prod_ ID
  3. Developers:复制 API Key
  4. Developers → Webhooks:地址填 https://你的域名/api/billing/webhook,复制 Webhook 密钥

本地 127.0.0.1 收不到 Webhook。要走一遍真实回调,在线上打开 Test Mode,用测试卡 4111 1111 1111 1111(任意未来日期和 CVC),不要切到 live 再拿自己的卡试。

流程

  • 定价页:已登录点“订阅”→ POST /api/billing/checkout → 跳到 Creem 付款页
  • 已有生效订阅时结账返回 409,定价页显示“当前套餐”和“管理订阅”;换套餐在 Creem 客户页完成
  • 付款后回到 /billing/success,页面轮询 /api/billing/status
  • 套餐只由 Webhook 写入 billing_subscription;验签失败 401,重复事件跳过,旧事件不覆盖新状态
  • 账号页显示套餐,“管理订阅”跳到 Creem 客户页(退订、换卡)
  • 有效状态:active、trialing、scheduled_cancel,且没过当前周期结束时间;active、trialing 额外宽限 2 天,等续费 Webhook
  • 页面价格来自 shared/plans.ts,实际扣款以 Creem 商品为准,改价两边一起改

检查

npm run billing:check:local                        # 对开发服务(读 .env)
npm run billing:check:local -- http://127.0.0.1:8797 # 对 Workers 预览(读 .dev.vars)

用本地 Webhook 密钥自己签名模拟事件,不访问 Creem;测完删掉测试数据。

切到 Creem 正式收款

切到 live 之后不要用自己的卡做测试付款,测试留在 test 模式。

  1. Creem 关闭 Test Mode,完成店铺审核,重建商品和 Webhook
  2. wrangler secret bulk 换上正式的 Key、Webhook 密钥、商品 ID,NUXT_CREEM_MODE=live
  3. 清掉测试数据:delete from billing_subscription where mode = 'test'; delete from billing_event where mode = 'test';