商业变现
2026-11-21·8 分钟
支付:多通道收银
Stripe、PayPal、微信支付、支付宝多通道聚合、强健的 Webhook 签名与本地免网关开发模式。
多合一聚合收银架构#
为了应对跨国出海与国内本土化收单的双重诉求,SaasOne 抽象出了统一的 PaymentProvider 接口规范(lib/payments/index.ts),切换渠道只是换一个环境变量:
- Stripe:全球信用卡与 Apple Pay / Google Pay 首选。
- PayPal:欧美老牌电子钱包,覆盖海外非信用卡用户群。
- 微信支付:国内移动端国民级支付,扫码与公众号内支付。
- 支付宝:国内个人与企业收单首选,支持手机网页支付与电脑网站支付。
- Creem:新兴数字商品极速收银平台,对独立开发者友好。
四通道配置速查#
| 通道 | PAYMENT_PROVIDER | 核心环境变量 | 结算特点 |
|---|---|---|---|
| Stripe | stripe | STRIPE_SECRET_KEY / STRIPE_WEBHOOK_SECRET / STRIPE_PRICE_* | 全球卡组织、Apple Pay / Google Pay |
| PayPal | paypal | PAYPAL_CLIENT_ID / PAYPAL_CLIENT_SECRET / PAYPAL_MODE | 欧美电子钱包,sandbox/live 双模式 |
| 微信支付 | WECHAT_PAY_MCHID / WECHAT_PAY_APPID / WECHAT_PAY_API_V3_KEY | Native 扫码 + JSAPI 公众号支付 | |
| 支付宝 | alipay | ALIPAY_APP_ID / ALIPAY_PRIVATE_KEY / ALIPAY_PUBLIC_KEY | RSA2 验签,电脑网站 + 手机网页 |
发起结账与回调处理#
四个通道共享同一个结账入口 POST /api/checkout,Webhook 回调统一落在 /api/webhooks/[provider] 并做签名验证 + 幂等落库:
渠道切换即环境变量
同一时刻仅激活一个通道;多通道并存灰度时,可按用户归属在结账路由内调用
providers[id].createCheckout() 自行分发。bash发起结账并跳转收银台
curl -X POST http://localhost:3000/api/checkout \
-H "Content-Type: application/json" \
-H "Cookie: better-auth.session_token=..." \
-d '{"planId": "pro_monthly"}'
# 200 响应:{ "url": "https://checkout...", "providerRef": "cs_test_..." }
# 前端拿到 url 后 window.location.assign(url) 即可Webhook 签名验证与幂等防重放#
所有支付回调均经过严格的双重防线校验:
1. 签名合法性校验:如 Stripe 的 stripe-signature 头验证,支付宝 RSA2 验签,防篡改伪造请求。
2. 幂等流水落库:收单前首先查询 payment_records 表中的渠道交易流水号(trade_no 或 session_id),若已标记为 succeeded 则直接返回 200,杜绝重复发货与双倍充值。
本地免网关快速测试 (Dev Direct Pay)#
在本地或内网开发时,无需申请真实的支付渠道或配置内网穿透(如 ngrok)。只要在环境变量设置 ALLOW_DEV_DIRECT_PAY=1,点击结账时收银组件将自动提供“本地直通结算”按钮,一秒模拟完成全流程扣款与权益发放。
生产环境注意事项
部署至生产环境时,务必将 ALLOW_DEV_DIRECT_PAY 设为 0 或直接删除该环境变量,防止未经授权的直接充值调用。
