DodoPayments
通过 DodoPayments 收款。
- 结账 托管结账页,需要先在 DodoPayments 建好产品
- 订阅 没有生命周期操作
- 客户门户 不支持
- 退款 不支持
准备工作
准备公网 HTTPS 站点、/admin/plans 中已上架的套餐,以及能管理商户设置的账号。
完成后,能通过签名通知核对一笔订单。
在 DodoPayments 完成准备
创建测试商品
打开 DodoPayments。切换至 Test Mode,在 Products 创建商品并复制产品 ID。
创建 API Key
在 Developer → API Keys 生成 API Key。
订阅付款通知
在 Webhooks 登记以 /api/billing/webhook/dodopayments 结尾的 HTTPS 地址,选择 payment.succeeded 和 payment.failed,复制完整签名密钥。
填写项目配置
回到 Kernlift 后台,打开 /admin/config/payment。选择 DodoPayments,填写公网成功 URL、取消 URL,将 API base URL 设为 https://test.dodopayments.com。
| 来源 | 后台字段 |
|---|---|
| API key | API key |
| Product ID | Dodo product ID |
| Signing secret | Webhook secret |
| 按套餐映射商品的 JSON,可选 | 套餐 Product ID |
勾选启用并点击 保存 provider。
验证
- 用沙箱买家账号在
/pricing购买套餐。 - 在
/admin/billing-webhooks确认签名校验通过。 - 在
/admin/orders找到同一订单,确认状态为已付款。
切换到正式环境
在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://live.dodopayments.com 一起保存。
常见问题
webhook 签名校验失败
粘贴含前缀的完整签名密钥,核对服务器时间并确认请求正文未经改写。