vm0（Okou）Stripe账单流程解析：应用内确认与托管付款页的决策边界

vm0OkouStripe账单流程解析应用内确认与托管付款页的决策边界【免费下载链接】okouOkou connects to the tools your team already uses and does the work — across marketing, sales, engineering, and operations, under your control.项目地址: https://gitcode.com/GitHub_Trending/vm/okouOkouvm0 项目通过 Stripe 完成订阅与付费其账单系统最容易被新手忽略的一点是在应用内确认付款In-App Confirm与Stripe 托管付款页Hosted Checkout之间如何选择。本文带你用 5 分钟看懂这套 Stripe 账单流程什么时候走托管结账页、什么时候直接在应用内确认、成功后如何回跳以及本地开发时如何用 Stripe CLI 转发 Webhook 事件。一、先看全景一次购买在 Okou 里会发生什么把 Okou 的账单流程想象成一家餐厅的两种点餐方式堂食托管付款页把客人带到 Stripe 收银台输卡、验证、扣款全部由 Stripe 完成结束后再送回你的餐厅。打包带走应用内确认如果客人之前已经存过付款方式你直接在店里刷卡完成不用再去收银台排队。Okou 在后端对每种购买类型套餐升级、并发订阅、充值包等都会先做一次路由判定结果只有两种路由结果含义用户看到的界面checkout走 Stripe 托管结账页跳转到 Stripe Checkout 页面preview走应用内预览 确认应用内展示订单预览一键确认付款这个判定逻辑集中在支付路由服务里路由判定与付款方式状态billing-payment-method.service.ts创建结账会话与确认购买billing-checkout.service.ts二、应用内确认什么条件下可以店里直接刷卡应用内确认并不是随时可用的它的前提是这个组织org在 Stripe 里已经有一个可用的默认付款方式。判定顺序大致是优先看组织名下订阅的默认付款方式没有订阅则看 Stripe Customer 的invoice_settings.default_payment_method都找不到就回退到托管结账页。对应代码见billingDefaultPaymentMethodStatus当路由判定结果为preview时ready才为 true说明应用内确认已就绪见 billing-payment-method.service.ts。确认阶段还有一个小细节应用内确认前先签发出一个带过期时间的预览令牌preview token防止预览价格和最终扣款金额之间出现时间差漏洞。相关实现在 billing-purchase-preview-token.service.ts。三、托管付款页checkout 会话与回跳地址走托管结账页时后端会为这次购买创建一个 Stripe Checkout Session成功后再带着 checkout 会话 ID 回跳到 Okou。这里有两个值得新手注意的安全设计成功/取消回跳地址白名单回跳 URL 由客户端传入并直达 Stripe为防止开放重定向与会话 ID 泄漏Okou 只允许回跳到自己持有的域名okou.ai及其子域、staging/预览域名等。见 billing-redirect.ts。幂等键idempotency key创建结账会话时支持传入幂等键网络重试不会创建重复的购买。购买完成后的账务收尾把发票落到业务库、更新组织套餐与权益分别由这些服务负责发票对账billing-operation-invoice.service.ts订阅与权益org-plan-entitlements.service.ts四、Webhook真正的支付成功通知从哪来托管结账页和应用内确认共用同一套事件驱动收尾Stripe 把checkout.session.completed、invoice.paid、customer.subscription.updated等事件推给 Webhook 端点由 webhooks-stripe.service.ts 统一消费再触发权益开通、发票入账等动作。本地开发时怎么收事件仓库自带了一套 Ansible 方案可以在开发机上按 PR 启动一个 Stripe CLI 监听进程把测试模式事件转发到你的预览 API启动监听器start-stripe-listener.yml清理监听器cleanup-stripe-listener.yml本地环境准备脚本ensure-stripe-cli.sh监听器会精确订阅 4 个事件checkout.session.completed、invoice.paid、customer.subscription.updated、customer.subscription.deleted并按job_ref隔离每个 PR 的目录与 systemd 服务互不干扰。五、决策边界速查表场景走哪条路原因首次购买套餐托管付款页无已存付款方式老用户续费/升级应用内确认有默认付款方式体验更快付款方式被拒或过期托管付款页兜底保证可完成交易预览令牌过期重新发起预览防止价格不一致扣款回跳地址不在白名单直接拒绝防开放重定向与会话 ID 泄漏六、延伸阅读端到端测试入口与 API 辅助脚本e2e/其中 API 辅助见 runner-api.bash账单相关服务目录turbo/apps/api/src/signals/services/测试规范了解这套测试如何组织docs/testing.md 一句话总结Okou 的 Stripe 账单 路由判定应用内确认 or 托管页 预览令牌 白名单回跳 Webhook 收尾。看懂这四块你就能在 vm0 代码库里自由穿梭任何一条订阅/扣款链路了。【免费下载链接】okouOkou connects to the tools your team already uses and does the work — across marketing, sales, engineering, and operations, under your control.项目地址: https://gitcode.com/GitHub_Trending/vm/okou创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考