[{"data":1,"prerenderedAt":28},["ShallowReactive",2],{"doc-payments":3},{"slug":4,"title":5,"description":6,"toc":7,"html":27},"payments","支付","按身份选收款渠道；当前代码只接了 Creem 的订阅结账、Webhook 和测试模式。",[8,10,12,14,17,20,22,24],{"id":9,"text":9},"按身份开户",{"id":11,"text":11},"一个站一个商户",{"id":13,"text":13},"渠道怎么切换",{"id":15,"text":16},"creem-变量","Creem 变量",{"id":18,"text":19},"creem-后台","Creem 后台",{"id":21,"text":21},"流程",{"id":23,"text":23},"检查",{"id":25,"text":26},"切到-creem-正式收款","切到 Creem 正式收款","\u003Cp>模板现在只实现了 Creem。正式收款开哪一家，按你手里的身份来；已经接上的 Creem 留着做兜底，不要因为换了主渠道就整段拆掉。\u003C\u002Fp>\n\u003Ch2 id=\"按身份开户\">按身份开户\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>你有什么\u003C\u002Fth>\n\u003Cth>优先开\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>中国大陆个人，身份证\u003C\u002Ftd>\n\u003Ctd>\u003Ca href=\"https:\u002F\u002Fwww.paypal.cn\">PayPal 中国\u003C\u002Fa> 个人卖家，或 \u003Ca href=\"https:\u002F\u002Fwww.waffo.ai\u002F\">Waffo Pancake\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>香港银行卡，身份用护照\u003C\u002Ftd>\n\u003Ctd>Stripe 个人账户，地区选香港\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>公司主体\u003C\u002Ftd>\n\u003Ctd>自己开 Stripe，或通过 \u003Ca href=\"https:\u002F\u002Fwww.subotiz.com\u002F\">Subotiz\u003C\u002Fa> 接入\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>2026-10-21 核对过的材料要求：PayPal 中国个人卖家要上传大陆身份证正反面并做人脸；Waffo 的身份验证写明中国大陆用 18 位身份证号，其它国籍用护照。Stripe 写明，居住地和账户所在国家不一致时，身份验证要用护照。审核能不能过，以提交当时的结果为准。\u003C\u002Fp>\n\u003Cp>Waffo 如果走哥飞的邀请码，群里说有 1000 美元免手续费。同一天在 Waffo 公开的定价页和 \u003Ca href=\"https:\u002F\u002Fwww.waffo.ai\u002Fzh\u002Fpancakers\">Builder 计划\u003C\u002Fa> 上没看到这条，公开活动写的是按贡献兑换额度，最高 500 美元流水的手续费全免。邀请码当时给多少，以注册页为准。\u003C\u002Fp>\n\u003Cp>Subotiz 的收款条款里，卡支付由 Stripe 处理：美国商户对应 Stripe LLC，香港对应 Stripe Payments Europe。另一种是 Merchant of Record，由 Subotiz 作为登记商户收款，再按周期结算。\u003C\u002Fp>\n\u003Ch2 id=\"一个站一个商户\">一个站一个商户\u003C\u002Fh2>\n\u003Cp>不管用哪家，每个网站单独开一个商户、一个 account。几个站共用同一个商户，会被当成 AB 站，一个站出问题会连累其它站。复制新产品时也要新开，见\u003Ca href=\"\u002Fdocs\u002Fnew-project\">复制成新产品\u003C\u002Fa>。\u003C\u002Fp>\n\u003Cp>至少接两个渠道，一个被风控时还能切到另一个。正式模式里不要用自己的银行卡试付，用各家的沙箱或测试模式。Creem 的测试卡见下文。\u003C\u002Fp>\n\u003Ch2 id=\"渠道怎么切换\">渠道怎么切换\u003C\u002Fh2>\n\u003Cp>群里的做法是用环境变量 \u003Ccode>PAY_PROVIDER\u003C\u002Fcode>：Stripe 优先，Creem 兜底。风控一变，改这个变量，不用为了换渠道发一版代码。\u003C\u002Fp>\n\u003Cp>模板里这个变量还没接。现在只有 Creem，\u003Ccode>NUXT_CREEM_API_KEY\u003C\u002Fcode> 和 \u003Ccode>NUXT_CREEM_WEBHOOK_SECRET\u003C\u002Fcode> 都填了才启用，装配在 \u003Ccode>server\u002Futils\u002Fbilling.ts\u003C\u002Fcode>。再加一家时，按 \u003Ccode>server\u002Fbilling\u002Fprovider.ts\u003C\u002Fcode> 的三个方法新写一个实现，由 \u003Ccode>PAY_PROVIDER\u003C\u002Fcode> 选择。页面和 Webhook 接口不用改。\u003C\u002Fp>\n\u003Cp>Creem 是 Merchant of Record：付款页、税务、退订都由它托管，本站只记录订阅状态。\u003C\u002Fp>\n\u003Ch2 id=\"creem-变量\">Creem 变量\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>变量\u003C\u002Fth>\n\u003Cth>说明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>NUXT_CREEM_API_KEY\u003C\u002Fcode>、\u003Ccode>NUXT_CREEM_WEBHOOK_SECRET\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>两项都填才启用支付，否则定价页按钮只去注册\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>NUXT_CREEM_MODE\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>test\u003C\u002Fcode>（默认）或 \u003Ccode>live\u003C\u002Fcode>；只有写 \u003Ccode>live\u003C\u002Fcode> 才真实扣款，其它值一律按测试\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>NUXT_CREEM_PRODUCTS_PRO\u003C\u002Fcode>、\u003Ccode>NUXT_CREEM_PRODUCTS_STUDIO\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>套餐对应的 Creem 商品 ID，键名对应 \u003Ccode>shared\u002Fplans.ts\u003C\u002Fcode> 的 id\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>测试和正式环境的 Key、商品、Webhook 各是一套，不通用。本地填 \u003Ccode>.env\u003C\u002Fcode>（Workers 预览填 \u003Ccode>.dev.vars\u003C\u002Fcode>），线上用 \u003Ccode>wrangler secret\u003C\u002Fcode>，见\u003Ca href=\"\u002Fdocs\u002Fdeploy\">部署\u003C\u002Fa>。\u003C\u002Fp>\n\u003Ch2 id=\"creem-后台\">Creem 后台\u003C\u002Fh2>\n\u003Col>\n\u003Cli>左下角打开 Test Mode\u003C\u002Fli>\n\u003Cli>Products：为每个付费套餐建一个按月订阅的商品，价格与 \u003Ccode>shared\u002Fplans.ts\u003C\u002Fcode> 一致，复制 \u003Ccode>prod_\u003C\u002Fcode> ID\u003C\u002Fli>\n\u003Cli>Developers：复制 API Key\u003C\u002Fli>\n\u003Cli>Developers → Webhooks：地址填 \u003Ccode>https:\u002F\u002F你的域名\u002Fapi\u002Fbilling\u002Fwebhook\u003C\u002Fcode>，复制 Webhook 密钥\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>本地 \u003Ccode>127.0.0.1\u003C\u002Fcode> 收不到 Webhook。要走一遍真实回调，在线上打开 Test Mode，用测试卡 \u003Ccode>4111 1111 1111 1111\u003C\u002Fcode>（任意未来日期和 CVC），不要切到 live 再拿自己的卡试。\u003C\u002Fp>\n\u003Ch2 id=\"流程\">流程\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>定价页：已登录点“订阅”→ \u003Ccode>POST \u002Fapi\u002Fbilling\u002Fcheckout\u003C\u002Fcode> → 跳到 Creem 付款页\u003C\u002Fli>\n\u003Cli>已有生效订阅时结账返回 409，定价页显示“当前套餐”和“管理订阅”；换套餐在 Creem 客户页完成\u003C\u002Fli>\n\u003Cli>付款后回到 \u003Ccode>\u002Fbilling\u002Fsuccess\u003C\u002Fcode>，页面轮询 \u003Ccode>\u002Fapi\u002Fbilling\u002Fstatus\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>套餐只由 Webhook 写入 \u003Ccode>billing_subscription\u003C\u002Fcode>；验签失败 401，重复事件跳过，旧事件不覆盖新状态\u003C\u002Fli>\n\u003Cli>账号页显示套餐，“管理订阅”跳到 Creem 客户页（退订、换卡）\u003C\u002Fli>\n\u003Cli>有效状态：\u003Ccode>active\u003C\u002Fcode>、\u003Ccode>trialing\u003C\u002Fcode>、\u003Ccode>scheduled_cancel\u003C\u002Fcode>，且没过当前周期结束时间；\u003Ccode>active\u003C\u002Fcode>、\u003Ccode>trialing\u003C\u002Fcode> 额外宽限 2 天，等续费 Webhook\u003C\u002Fli>\n\u003Cli>页面价格来自 \u003Ccode>shared\u002Fplans.ts\u003C\u002Fcode>，实际扣款以 Creem 商品为准，改价两边一起改\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"检查\">检查\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-bash\">npm run billing:check:local                        # 对开发服务（读 .env）\nnpm run billing:check:local -- http:\u002F\u002F127.0.0.1:8797 # 对 Workers 预览（读 .dev.vars）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>用本地 Webhook 密钥自己签名模拟事件，不访问 Creem；测完删掉测试数据。\u003C\u002Fp>\n\u003Ch2 id=\"切到-creem-正式收款\">切到 Creem 正式收款\u003C\u002Fh2>\n\u003Cp>切到 live 之后不要用自己的卡做测试付款，测试留在 test 模式。\u003C\u002Fp>\n\u003Col>\n\u003Cli>Creem 关闭 Test Mode，完成店铺审核，重建商品和 Webhook\u003C\u002Fli>\n\u003Cli>\u003Ccode>wrangler secret bulk\u003C\u002Fcode> 换上正式的 Key、Webhook 密钥、商品 ID，\u003Ccode>NUXT_CREEM_MODE=live\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>清掉测试数据：\u003Ccode>delete from billing_subscription where mode = &#39;test&#39;; delete from billing_event where mode = &#39;test&#39;;\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n",1795050222295]