Coin OpenAPI

异步通知 ​

下单传入 notify_url 后，平台在订单终态向该地址 POST JSON。未传或为空则不发送。异步通知只是结果通知，终态以查询接口为准；可能延迟、重复，须幂等处理。

公共投递规则见本页；各事件载荷见对应事件页。

事件 ​

事件触发 status载荷
汇兑订单FINISHED / FAILED / CANCELLED与 查询汇兑订单 的 data 一致
提现订单FINISHED / FAILED / CANCELLED与 查询提现订单 的 data 一致

投递规则 ​

  • 方法：POST，Content-Type: application/json
  • 路径：商户 notify_url（path 与 query 原样使用）
  • Body：无 {status,msg,data} 封装
  • 成功：HTTP 200（响应 Body 不解析）
  • 非 200、超时（3 秒）或无法连接会重试；最多 8 次（含首次），间隔约 0 / 5s / 15s / 1min / 5min / 15min / 30min / 1h
  • 按 trade_sn / order_no 做幂等

请求 Header ​

算法与 签名规则 相同。平台用平台私钥加签；商户用商户后台下发的平台公钥（plat_public_key）验签。

text
Content-Type: application/json
X-Merchant-Id: <merchant_id>
X-Timestamp: 1710000000
X-Nonce: a9f3c1d47e8b9a2c
Digest: SHA-256=<Base64(SHA256(body))>
Authorization: Signature keyId="<merchant_id>",alg="ES256",headers="(request-target) x-timestamp x-nonce digest",signature="<Base64>"
字段类型说明
X-Merchant-Idstring与 Authorization.keyId 一致
X-Timestampint64秒级 Unix 时间戳
X-Noncestring随机串
DigeststringSHA-256= + Base64(SHA256(原始 body))
AuthorizationstringSignature keyId=...,alg="ES256",headers="...",signature="..."

Canonical String 的 (request-target) 为 post + notify_url 的 path（含 query）。

验签：校验 Digest 与原始 body 一致，重建 Canonical String，用平台公钥验 Authorization.signature。验签通过前不要处理业务。