各渠道支持什么
以下是代码中适配器当前已实现的能力。
| 渠道 | 积分包 | 退款 | 订阅 | 停止续费 | 整账期退款 |
|---|---|---|---|---|---|
| Stripe | 支持 | 支持 | 支持 | 支持 | 支持 |
| PayPal | 支持 | 支持 | 支持 | 支持 | 支持 |
| Waffo | 支持 | 支持 | 支持 | 支持 | 支持 |
| Dodo Payments | 支持 | 支持 | 支持 | 支持 | 支持 |
每个渠道都有独立的测试和正式连接。源码支持不等于线上已验证:开放正式购买前,请先核对你自己的账号和商品。
从结账到积分到账
每个渠道都走同样的步骤,无论哪个渠道收的款,账本记录都一致。
保存订单快照
打开收银台之前,商品、价格、币种、渠道和环境已保存在服务端。
验证通知
Webhook 先验签,再与保存的订单核对。
每个事件只处理一次
事件先保存再处理,重复的通知会被识别并忽略。
付款与发放同时完成
付款与它发放的积分在同一个原子步骤中写入。
不以返回页为准
从收银台返回不代表已付款。站点在服务端向渠道核查订单。
三种支付模式
全站模式决定谁可以购买,与各渠道的测试、正式连接分开设置。
off- 不接受新订单。已有订单、续费和退款照常处理。
admin_test- 只有管理员可以通过测试连接购买。
live- 客户正式购买。管理员仍可选择测试路径。
四个支付渠道的订阅
Stripe、PayPal、Waffo 和 Dodo Payments 均支持月付与年付套餐。售卖前须映射套餐,并记录退款验收依据。
- 续费依据渠道自己的账单记录入账,迟到的通知会对应到正确的账期。
- 更换套餐时,客户先停止续费,在已付账期结束后再购买新套餐。
- 可以通过渠道退还一整个账期。
接入你自己的渠道
Dodo Payments 就是这样接入的,订单流程、积分账本和退款都无需改动。
编写适配器
实现支付渠道接口:收银台、通知解析和退款。
只声明真正可用的能力
列出适配器真正实现的订阅操作,其余一律拒绝。
注册
加入 modules/payments/registry.server.ts,并写明它的密钥和设置从哪里读取。