# 从 Cryptomus、NOWPayments、Coinbase Commerce 迁移

> 从 Cryptomus、NOWPayments 或 Coinbase Commerce 换到 blockwallets,只改基础地址和密钥:每家要改什么,以及各自兼容接口的完整说明。
>
> HTML: https://blockwallets.io/docs/migrate · English: https://blockwallets.io/docs/migrate.md?lang=en

## 迁移到 blockwallets

blockwallets 有三家网关的兼容接口。下面找到你原来用的那家:表里就是要改的全部东西。

### 要改什么

| 原来用的 | 原来的地址 | 换成 | 新凭据 | 回调签名 |  |
| --- | --- | --- | --- | --- | --- |
| **Cryptomus** | `https://api.cryptomus.com` | `https://blockwallets.io` | merchant + API key | 请求体里的 `sign` 字段,`md5(base64(…) + API key)` | [完整说明 →](https://blockwallets.io/docs/cryptomus?lang=zh#cryptomus) |
| **NOWPayments** | `https://api.nowpayments.io/v1` | `https://blockwallets.io/nowpayments/v1` | API key + IPN secret | `x-nowpayments-sig`(HMAC-SHA512) | [完整说明 →](https://blockwallets.io/docs/nowpayments?lang=zh) |
| **Coinbase Commerce** | `https://api.commerce.coinbase.com` | `https://blockwallets.io/coinbase/` | API key + webhook shared secret | `X-CC-Webhook-Signature`(HMAC-SHA256) | [完整说明 →](https://blockwallets.io/docs/coinbase-commerce?lang=zh) |

blockwallets 除了 [Cryptomus 兼容接口](https://blockwallets.io/docs/cryptomus?lang=zh),也提供 **NOWPayments** 和 **Coinbase Commerce** 的兼容接口:路径、鉴权头、请求 / 响应字段、状态和回调签名都照它们的官方文档,接过这两家的代码通常**只改 base URL 和密钥**。Coinbase Commerce 自 2026-03-31 起不再服务美国 / 新加坡以外的商户,可以直接换过来。

底层就是 blockwallets 的账单:收款地址是你自己的,付款页是我们的收银台,到账后链上确认、再找第二家节点核对一遍才算付款成功。下面先讲三步接入,再分别列出两家的支持范围和**与官方接口的差异**——没实现的参数会明确报错,不会悄悄忽略。

### 测试模式

test 凭据建的单走各链的测试网,回调用 test 的 IPN secret / shared secret 签名,和 live 完全隔离:test 的 key 查不到 live 的单。

其余细节(收银台、确认数、网络与最低金额、退款)和 [主文档](https://blockwallets.io/docs/cryptomus?lang=zh) 一样。