迁移到 blockwallets
blockwallets 有三家网关的兼容接口。下面找到你原来用的那家:表里就是要改的全部东西。
要改什么
| 原来用的 | 原来的地址 | 换成 | 新凭据 | 回调签名 | |
|---|---|---|---|---|---|
| Cryptomus | https://api.cryptomus.com | https://blockwallets.io | merchant + API key | 请求体里的 sign 字段,md5(base64(…) + API key) | 完整说明 → |
| NOWPayments | https://api.nowpayments.io/v1 | https://blockwallets.io/nowpayments/v1 | API key + IPN secret | x-nowpayments-sig(HMAC-SHA512) | 完整说明 → |
| Coinbase Commerce | https://api.commerce.coinbase.com | https://blockwallets.io/coinbase/ | API key + webhook shared secret | X-CC-Webhook-Signature(HMAC-SHA256) | 完整说明 → |
blockwallets 除了 Cryptomus 兼容接口,也提供 NOWPayments 和 Coinbase Commerce 的兼容接口:路径、鉴权头、请求 / 响应字段、状态和回调签名都照它们的官方文档,接过这两家的代码通常只改 base URL 和密钥。Coinbase Commerce 自 2026-03-31 起不再服务美国 / 新加坡以外的商户,可以直接换过来。
底层就是 blockwallets 的账单:收款地址是你自己的,付款页是我们的收银台,到账后链上确认、再找第二家节点核对一遍才算付款成功。下面先讲三步接入,再分别列出两家的支持范围和与官方接口的差异——没实现的参数会明确报错,不会悄悄忽略。
测试模式
test 凭据建的单走各链的测试网,回调用 test 的 IPN secret / shared secret 签名,和 live 完全隔离:test 的 key 查不到 live 的单。
其余细节(收银台、确认数、网络与最低金额、退款)和 主文档 一样。