Clotho 快速接入 — 5 分钟收到第一笔款

Clotho 是非托管支付网关:你的私钥永远在你自己手里。服务器只保存 你的账户 xpub(扩展公钥),并用它为每笔订单派生独立的收款地址。

1. 注册并设置钱包(约 2 分钟)

1. 在 app.clotho.moira-e.com 注册(邮箱 + 验证)。
2. 打开 wallet-setup.clotho.moira-e.com —— 它会在你的浏览器里 生成 24 个助记词(不会发送到任何地方 —— 生成器完全开源,MIT,可审计可自行构建)。抄写助记词,完成确认测验, 然后复制两条账户 xpub(TRON + BSC)。
3. 回到控制台 → 钱包 → 把两条 xpub 注册到 test 环境。

随时可以把同一套助记词导入 TronLink 或 Trust Wallet —— 所有入金都落在你钱包控制的地址里。

2. 创建 API 密钥

控制台 → API 密钥 → 创建一个 test 密钥,scope 选 orders:write 和 orders:read。完整密钥(ck_test_...)只展示一次。

3. 添加 Webhook 端点

控制台 → Webhooks → 填入你的 HTTPS 接收地址。保存好返回的 whsec_... 签名密钥,并对每次投递验签 —— 见 Webhook 指南。

4. 创建订单

curl -s https://api.clotho.moira-e.com/api/v1/orders \
  -H "Authorization: Bearer ck_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-0001" \
  -d '{
    "external_id": "order-0001",
    "chain": "tron",
    "amount_micro": 5000000,
    "metadata": {"player_id": "p_42"}
  }'

响应中带有 deposit_address(收款地址)和 pay_url(托管收银台 链接)—— 把 pay_url 发给你的客户(带二维码和倒计时的收银台页面), 或者自己渲染地址。在 pay_url 后追加 ?lang=zh 可强制收银台显示中文。

5. 收款到账

转账达到最终确认深度后(TRON:19 个区块,约 1 分钟),你会依次收到 payment.confirmed 和 order.paid 两个 webhook,同时 GET /api/v1/orders/{id} 的 status 变为 "paid"。

金额在所有链上都统一用微 USDT 整数表示(1 USDT = 1,000,000)—— 没有小数,没有浮点惊喜。

上线正式环境

live 密钥需要先通过 KYB 审核:在控制台提交你的企业信息;审核通过后 即可注册 live 环境的钱包和密钥。test 环境对接的是公共测试网 (TRON Nile / BSC chapel),全流程都可以用水龙头测试币演练。

完整 API 参考:openapi.yaml。