Coin OpenAPI

开发测试 ​

特别注意（必读） ​

  • 若出现 HTTP 非 200、请求超时、连接中断，或 Body status 非成功且无法确认业务是否已受理，对接方须按业务自行判断是否重新提交，禁止在未核实结果前盲目重试。
  • 资金转移接口（如汇兑下单、提现下单）在网络异常场景下，服务端极有可能已受理并继续执行（已进入打款流程）。此时再次提交，可能造成重复下单 / 重复出款与资金损失。
  • 建议：对写接口以商户侧 trade_sn 做幂等管控；遇超时或不确定结果时，先调用对应查询接口核对订单状态，仅在确认未创建成功后再决定是否重新提交。

测试配置 ​

测试域名：https://coin-api-test.adox.group（开发 / 测试环境；接口路径仍为 /coin/v1/*）

测试商户号：M1781678976331286876（该商户跳过 IP 白名单；正式环境请在商户后台上传 EC P-256 公钥）

商户私钥（请求加签，PKCS#8）：

text
-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQgvM9J/kTRqV4JutlF
hWs1YeaqaPfvK+g3vAFA0dlETzWhRANCAATxBWYlmz1cF4qTHGzF/B9zJM2LzLLI
AQj3m7bO+ZAQ7+YWevRRv98lJNGXuDnqu4jp0Gq0vveZkqAc1jYo2yhV
-----END PRIVATE KEY-----

商户公钥：

text
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8QVmJZs9XBeKkxxsxfwfcyTNi8yy
yAEI95u2zvmQEO/mFnr0Ub/fJSTRl7g56ruI6dBqtL73mZKgHNY2KNsoVQ==
-----END PUBLIC KEY-----

签名自检 ​

非正式业务接口，只用于对照加签。仅测试环境、仅测试商户可用。 正式环境及其他商户调用返回无权限。

详见 签名自检接口。

实操建议 ​

  • 测试环境用测试商户先打 POST /coin/v1/test/sign：对照 digest / sign_string；看 is_verify（勿与返回 sign 做字符串相等比较）。该接口正式环境及其他商户不可用。
  • Digest 必须对最终发出的原始 body 字节计算，不要重新序列化。
  • Canonical String 冒号后只能有一个空格，换行用 LF。
  • Authorization 生成后不要再改 X-Timestamp / X-Nonce / Body。
  • quote_id 有效期很短（系统询价 expires_in 一般为 5 秒），须在过期前下单。
  • 币种字段须为大写，金额精度见 货币。
  • 建议记录请求原文、Canonical String、响应原文，便于测试排障。