支付
按身份选收款渠道;当前代码只接了 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 后台
- 左下角打开 Test Mode
- Products:为每个付费套餐建一个按月订阅的商品,价格与
shared/plans.ts一致,复制prod_ID - Developers:复制 API Key
- 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 模式。
- Creem 关闭 Test Mode,完成店铺审核,重建商品和 Webhook
wrangler secret bulk换上正式的 Key、Webhook 密钥、商品 ID,NUXT_CREEM_MODE=live- 清掉测试数据:
delete from billing_subscription where mode = 'test'; delete from billing_event where mode = 'test';