网关兼容 —— 不改代码完成迁移

已经对接过其他加密支付网关?clotho 原生兼容五家网关的接入格式。保留你现有的 SDK 和对接代码 —— 只换 base URL 和密钥,入金直接结算到你自己的钱包,而不是托管方的。

在控制台开通(网关兼容 → 开通网关):选择环境、回调地址和默认链,clotho 一次性返回全部凭证 —— 包括用各网关原生格式签名回调的密钥。

支持的网关

网关	接入地址	认证	入金回调
UdunCloud(有盾云)	`api.clotho.moira-e.com/compat/udun`	merchantId + md5 签名	udun 信封,回 `success`
Coinbase Commerce	`api.clotho.moira-e.com/compat/coinbase`	`X-CC-Api-Key`	`X-CC-Webhook-Signature`(HMAC-SHA256)
NOWPayments	`api.clotho.moira-e.com/compat/nowpayments`	`x-api-key`	`x-nowpayments-sig`(HMAC-SHA512 排序 JSON)
BTCPay Greenfield	`api.clotho.moira-e.com/compat/btcpay`	`Authorization: token …`	`BTCPay-Sig: sha256=…`
CoinPayments	`api.clotho.moira-e.com/compat/coinpayments/api.php`	公钥 + `HMAC` 头(SHA512)	IPN 用 `ipn_secret` 签名

示例

Coinbase Commerce SDK —— 只改 base URL 和密钥:

const { Client, Charge } = require('coinbase-commerce-node')
Client.init('来自 clotho 的兼容密钥')
Client.setRequestLibraryConfig({ baseUrl: 'https://api.clotho.moira-e.com/compat/coinbase' })

const charge = await Charge.create({
  name: '黄金礼包', description: '1000 金币',
  pricing_type: 'fixed_price',
  local_price: { amount: '5.00', currency: 'USD' },
})
// charge.hosted_url 现在指向 clotho 的托管收银台

NOWPayments —— 请求不变,ticker 决定链:

curl -s https://api.clotho.moira-e.com/compat/nowpayments/v1/payment \
  -H "x-api-key: <你的 clotho 兼容密钥>" \
  -H "Content-Type: application/json" \
  -d '{"price_amount": 5, "price_currency": "usd",
       "pay_currency": "usdttrc20", "order_id": "RGDBP-21314"}'

支持的 ticker 包括 usdttrc20、usdterc20、usdtbsc、 usdtmatic、usdtarb、usdtop、usdtarc20 及 usdc* 系列 (GET /v1/currencies 返回实时列表)。

CoinPayments —— currency2 用它家的点号语法:USDT.TRC20、 USDT.ERC20、USDT.BEP20、USDC……

BTCPay —— 发票挂在你的兼容店铺 id 下: POST /compat/btcpay/api/v1/stores/{storeId}/invoices,请求体 {"amount": "5.00", "currency": "USD"};支付方式命名遵循 USDT-TRON 约定。

有意为之的差异

没有提现接口。 clotho 是非托管的 —— 入金落在由你的 xpub 派生的地址里,本来就在你手上,无从"提现";提现端点会返回清晰的错误说明。
价格按 1:1 以稳定币结算(USD ≈ USDT/USDC),不做法币汇率。
状态枚举、签名配方、字段类型与各网关官方 SDK 逐字节一致 (连它们的怪癖也一并复刻),现有的验签代码无需改动。

多链

订单(原生或兼容)可在 8 条链上结算:TRON、BSC、Ethereum、 Arbitrum、Optimism、Base、Polygon、Avalanche —— 支持 USDT 或 USDC(Base 仅 USDC)。EVM 钱包注册一次即覆盖全部 EVM 链:同一 xpub 在各链派生出相同地址,加链对你零成本。

原生 API 用可选的 currency 字段选择代币:

{ "external_id": "order-1", "chain": "polygon",
  "currency": "USDC", "amount_micro": 5000000 }