SaasOne v2.0 Docs
商业变现
2026-11-21·8 分钟

支付:多通道收银

Stripe、PayPal、微信支付、支付宝多通道聚合、强健的 Webhook 签名与本地免网关开发模式。

多合一聚合收银架构#

为了应对跨国出海与国内本土化收单的双重诉求,SaasOne 抽象出了统一的 PaymentProvider 接口规范(lib/payments/index.ts),切换渠道只是换一个环境变量:
- Stripe:全球信用卡与 Apple Pay / Google Pay 首选。

- PayPal:欧美老牌电子钱包,覆盖海外非信用卡用户群。

- 微信支付:国内移动端国民级支付,扫码与公众号内支付。

- 支付宝:国内个人与企业收单首选,支持手机网页支付与电脑网站支付。

- Creem:新兴数字商品极速收银平台,对独立开发者友好。

四通道配置速查#

通道PAYMENT_PROVIDER核心环境变量结算特点
StripestripeSTRIPE_SECRET_KEY / STRIPE_WEBHOOK_SECRET / STRIPE_PRICE_*全球卡组织、Apple Pay / Google Pay
PayPalpaypalPAYPAL_CLIENT_ID / PAYPAL_CLIENT_SECRET / PAYPAL_MODE欧美电子钱包,sandbox/live 双模式
微信支付wechatWECHAT_PAY_MCHID / WECHAT_PAY_APPID / WECHAT_PAY_API_V3_KEYNative 扫码 + JSAPI 公众号支付
支付宝alipayALIPAY_APP_ID / ALIPAY_PRIVATE_KEY / ALIPAY_PUBLIC_KEYRSA2 验签,电脑网站 + 手机网页

发起结账与回调处理#

四个通道共享同一个结账入口 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 或直接删除该环境变量,防止未经授权的直接充值调用。
支付:多通道收银 — SaasOne 开发文档