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,复制完整签名密钥。

官方说明 · Dodo 产品 · 官方接入示例

填写项目配置

回到 Kernlift 后台,打开 /admin/config/payment。选择 DodoPayments,填写公网成功 URL、取消 URL,将 API base URL 设为 https://test.dodopayments.com。

来源后台字段
API keyAPI key
Product IDDodo product ID
Signing secretWebhook secret
按套餐映射商品的 JSON,可选套餐 Product ID

勾选启用并点击 保存 provider。

Kernlift 后台的 DodoPayments 配置字段

验证

  1. 用沙箱买家账号在 /pricing 购买套餐。
  2. 在 /admin/billing-webhooks 确认签名校验通过。
  3. 在 /admin/orders 找到同一订单,确认状态为已付款。

切换到正式环境

在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://live.dodopayments.com 一起保存。

常见问题

webhook 签名校验失败

粘贴含前缀的完整签名密钥,核对服务器时间并确认请求正文未经改写。

下一步

接入支付服务商