你需要什么
| 字段 | 它做什么 |
|---|---|
| API key ID | 标识你的 MakePay API key，让我们调用正确的账户。 |
| API key secret | 让我们在你的账户上创建 MakePay 结账。机密。 |
| Webhook secret | 确认一条 webhook 确实来自 MakePay。机密。 |
| 成功网址 | 买家在完成付款后落到哪里。 |
| 失败网址 | 买家在付款失败或取消后落到哪里。 |
MakePay 在生成 API key 时会一起发布 API key ID 和 secret；webhook secret 是一个单独的值，与它的回调设置无关。
我们为什么要每个字段
API key ID
标识我们使用哪个 MakePay key 来认证。它本身不是机密，但它与下面的 secret 配对使用。
API key secret
授权创建结账，使付款通过你的 MakePay 账户进行，资金结算到你的钱包。MakePay 仅在生成密钥后立即显示一次。
Webhook secret
证明一条传入的 webhook 真的来自 MakePay，于是没人能伪造一个"已付款"事件。它是一个与 API key 不同的值。
成功与失败网址
普通设置：买家在付款或付款失败或取消后落到哪里。非机密。
设置
- 在 MakePay 中生成 API key
登录 MakePay，打开 API & SDK → API integrations。在 API keys 下，点击 Generate API Key，给它取个名字，比如"Coin Moebius"，然后创建。MakePay 在生成后立即显示一次 API key ID 和它的 secret — 现在就复制两个，因为 secret 不会再显示。
MakePay → API & SDK → API integrations → Generate API Key 把 API key secret 当作密码对待。如果丢失了，生成一个新 key，而不是尝试恢复旧的。
- 找到你的 Coin Moebius 项目 ID
在另一个标签页，打开 Coin Moebius 后台里的你的项目，复制项目名下的项目 ID。你的 MakePay 回调 URL 是把那个 ID 代入下面这个地址 — 你将在下一步粘贴到 MakePay 里。
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → 你的项目 → Project ID 已连接的渠道卡（最后一步）会显示相同的 URL，所以你可以随时回来重新复制。
- 设置回调 URL 并复制 webhook secret
回到 MakePay，滚到 Delivery → Callback URL configuration。点击 Edit Callback URL，把你的 Coin Moebius webhook URL 粘进 active destination，然后保存。然后在 Webhook signing 下，复制签名 secret（如果没有值，点击 Regenerate secret）— 那就是 Coin Moebius 要求的 Webhook secret。
MakePay → Delivery → Callback URL configuration MakePay 在每次商户可见的状态变化后都会 POST 一条递送更新到这个地址。签名 secret 与 API key 分开 — 两个都需要。
- 在 Coin Moebius 后台里连接
在 Coin Moebius 里，打开 Providers → Add provider → MakePay。粘贴你的 API key ID、API key secret 和 Webhook secret，然后设置成功网址和失败网址（买家在付款或付款失败后落到的地方）。点击 Save。
Coin Moebius → Add provider → MakePay 保存的 secret 会保持隐藏。要后来改一个，选 Replace 并输入新值。
- 你已连接
MakePay 现在出现在你的 Providers 标签页上，显示它连接的日期和它期望的 webhook URL。如果还没有，把那个 URL 粘进 MakePay 的回调设置。用 Edit 来轮换密钥，用 Disconnect 来删除，用测试模式开关来走一笔订单，而不影响你的真实数据。
Coin Moebius → Providers → MakePay（已连接）
连接之后
上线前跑一笔订单：
- 在已连接的 MakePay 卡上打开测试模式开关，来走一笔订单，而不影响你的真实数据。
- 创建一个商品，并把买按钮放到一个页面上（本地 HTML 文件也行），指向你的项目。
- 通过 MakePay 完成结账。
- 打开"交易"标签页。当新行的状态到达 succeeded 时，你的凭据和 webhook 就都端到端工作了。
当你准备好接收真实付款时，关掉测试模式。
问题排查
从后台开始：确认 MakePay 卡显示已连接，且 webhook URL 与 MakePay 里保存的回调目标相匹配。
付款完成但订单仍停在待处理。
webhook 没有到达或没有验证通过。确认 MakePay 里的回调 URL 与你项目的 webhook URL 完全匹配，且 Coin Moebius 里的 Webhook secret 与 MakePay 里的签名 secret 相同。
保存渠道被拒绝。
API key ID、API key secret 和 Webhook secret 都是必需的。从 MakePay 重新复制 — secret 只显示一次，所以如果你没有了，生成一个新 key。
一笔测试订单从未出现在交易里。
在运行买按钮前，打开 MakePay 卡上的测试模式开关，并确保商品指向同一项目。
值得了解
非托管的. MakePay 把加密货币结算到你自己的钱包。Coin Moebius 从不持有资金，也无法移动。
轮换 secret. 随时生成一个新 API key 或重新生成 webhook 签名 secret，然后在后台里选 Replace 并粘进新值。编辑时 secret 字段保持空白。
有问题？ Join our Discord