连接 Dodo Payments | Coin Moebius

你需要什么

字段	它做什么
API key	让我们调用 Dodo 来创建托管结账。机密。
Webhook signing secret（whsec_…）	确认一个 webhook 确实来自 Dodo。机密。
Return URL	买家在结账后落到哪里。

授权创建托管结账，使扣款通过你的账户进行。

证明一个传入的 webhook 真的来自 Dodo，于是没人能伪造一个“已付款”事件。它是一个与 API key 不同的值。

普通设置：买家在结账后落到哪里。非机密。

使用测试模式（免费）
Dodo 有一个独立的测试环境。测试模式密钥对 Dodo 测试主机运行，不会发生真钱流动。
1. 在 app.dodopayments.com 登录。
2. Dodo 把 Live 和 Test 密钥分开。先把测试设好，再在正式里重复一遍。
复制你的 API key
去 Developer → API Keys，复制 Test 密钥以便验证，或 Live 密钥以接收真实付款。
Dodo → Developer → API Keys
添加 webhook
1. 在 Dodo 里添加一个 webhook。
2. 把 webhook URL 设为你的项目 webhook 地址（见下）。
3. 复制 webhook signing secret（whsec_…）。在测试和正式里分别添加一个单独的 webhook。
```
https://api.coinmoebius.com/webhook/dodopayments/<your project id>
```
Dodo → Developer → Webhooks
在后台里连接
添加渠道 → Dodo Payments。输入 Return URL 和正式组（Live API key、Live webhook signing secret）。添加可选的测试组以便先验证。测试组是成对的：同时加一个测试 API key 和一个测试 webhook secret，或两个都留空。正式和测试各自分别检查。

上线前跑一笔测试付款：

创建一个商品，并把它的环境设为 Testing。这会让该商品跑在你的测试凭据上，于是你可以下一整单而不动真钱。（如果你跳过了测试组，一个 Testing 商品会回退到正式，所以请先添加它。）
把买按钮放到一个页面上（本地 HTML 文件也行），指向你的项目。
在 Dodo 的测试模式里完成结账。
打开“交易”标签。一行带 Testing 标签的新行出现。当它的状态到达 succeeded 时，你的凭据和 webhook 就都端到端工作了。

准备好接收真实付款时，把商品环境切换到 Live。

从“验证”开始。在后台里，点击“验证”（或“验证测试凭据”）来核对你的 API key。

在 Test 选项卡里添加一个测试 API key，保存该渠道，然后重新打开对话框并验证。

确认 webhook URL 一致，且 signing secret 与同一环境里的 webhook 一致（测试对测试，正式对正式）。

测试组是成对的：同时加一个测试 API key 和一个测试 webhook secret，或两个都留空。

Dodo Dashboard → Developer → Webhooks → Send Example（或 Dodo CLI）指向你的 webhook URL，然后看着订单更新。

仅限一次性付款. Coin Moebius 把 Dodo 用于单笔付款，而非订阅。

轮换密钥. 随时滚动 API key 或 webhook secret，然后粘上新值。编辑时机密字段保持空白。