NAV
go php js java

风控回调

提现订单二次复核

请求示例:

POST <商户提供的提现复核地址>
Content-Type: application/json
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"data":{"trade_id":"W202610190001","user_id":"10086","coin":"usdt_trc20","address":"TUCx9tabZSDRa4MxJzw9R3x5EiWNsvMdE7","amount":"100.5"}}

请求待签串(4 行,\n 连接,末尾无换行):

1792382460
9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c
RSA-SHA256
<请求 body 原始字节的 SHA-256 小写 hex>

商户处理示例:

// riskPlatformKey 为平台风控公钥,riskPrivateKey 为商户风控私钥(cbc.ParsePublicKey / cbc.ParsePrivateKey 解析)
http.HandleFunc("/risk/withdraw/check", func(w http.ResponseWriter, r *http.Request) {
    body,  := io.ReadAll(r.Body)
    status, tradeID := 5400, ""
    if err := cbc.VerifyBody(r.Header, body, riskPlatformKey, true); err == nil {
        // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地提现单,得出 status
        var req struct {
            Data struct {
                TradeID string json:"trade_id"
            } json:"data"
        }
        json.Unmarshal(body, &req)
        tradeID, status = req.Data.TradeID, 200
    }
    out,  := json.Marshal(map[string]any{"status": status, "data": map[string]string{"trade_id": tradeID}})
    headers, _ := cbc.SignBody(out, riskPrivateKey)
    for k, v := range headers {
        w.Header().Set(k, v)
    }
    w.Header().Set("Content-Type", "application/json")
    w.Write(out)
})
// $riskPlatformPublicKeyPem 为平台风控公钥,$riskPrivateKeyPem 为商户风控私钥
$body = file_get_contents('php://input');
$headers = array_change_key_case(getallheaders(), CASE_LOWER);
$status = 5400;
$tradeId = '';
try {
    CbcClient::verifyBody($headers, $body, $riskPlatformPublicKeyPem, true);
    // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地提现单,得出 status
    $req = json_decode($body, true);
    $tradeId = $req['data']['trade_id'];
    $status = 200;
} catch (RuntimeException $e) {
    // 验签失败返回 5400,平台稍后重试
}
$out = json_encode(['status' => $status, 'data' => ['trade_id' => $tradeId]]);
foreach (CbcClient::signBody($out, $riskPrivateKeyPem) as $k => $v) {
    header("$k: $v");
}
header('Content-Type: application/json');
echo $out;
// riskPlatformPublicKeyPem 为平台风控公钥,riskPrivateKeyPem 为商户风控私钥
app.post('/risk/withdraw/check', express.raw({ type: 'application/json' }), (req, res) => {
  let status = 5400;
  let tradeId = '';
  try {
    verifyBody((name) => req.get(name), req.body, riskPlatformPublicKeyPem, true);
    // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地提现单,得出 status
    tradeId = JSON.parse(req.body).data.trade_id;
    status = 200;
  } catch (e) {
    // 验签失败返回 5400,平台稍后重试
  }
  const out = Buffer.from(JSON.stringify({ status, data: { trade_id: tradeId } }));
  res.set(signBody(out, riskPrivateKeyPem)).type('application/json').send(out);
});
// riskPlatformKey 为平台风控公钥,riskPrivateKey 为商户风控私钥;parseTradeId 用项目里的 JSON 库取 data.trade_id
@PostMapping(value = "/risk/withdraw/check", produces = "application/json")
public ResponseEntity<byte[]> withdrawCheck(@RequestHeader HttpHeaders headers, @RequestBody byte[] body) throws Exception {
    Map<String, String> sig = new HashMap<>();
    for (String name : new String[]{"X-Cbc-Timestamp", "X-Cbc-Nonce", "X-Cbc-Sign-Alg", "X-Cbc-Signature"}) {
        sig.put(name, headers.getFirst(name));
    }
    int status = 5400;
    String tradeId = "";
    try {
        CbcClient.verifyBody(sig, body, riskPlatformKey, true);
        // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地提现单,得出 status
        tradeId = parseTradeId(body);
        status = 200;
    } catch (Exception e) {
        // 验签失败返回 5400,平台稍后重试
    }
    byte[] out = CbcClient.toJson(Map.of("status", status, "data", Map.of("trade_id", tradeId)))
            .getBytes(StandardCharsets.UTF_8);
    HttpHeaders respHeaders = new HttpHeaders();
    CbcClient.signBody(out, riskPrivateKey).forEach(respHeaders::set);
    return ResponseEntity.ok().headers(respHeaders).body(out);
}

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"status":200,"msg":"success","data":{"trade_id":"W202610190001"}}

HTTP Request

POST 具体回调地址,由商户提供给平台方

参数名 说明
X-Cbc-Timestamp 请求时间,Unix 秒
X-Cbc-Nonce 随机串,32 位小写 hex,每次请求都不同
X-Cbc-Sign-Alg 固定 RSA-SHA256
X-Cbc-Signature 对 canonical 的签名,Base64 标准编码

签名 = Base64(RSA_PKCS1v15_Sign(平台风控私钥, SHA-256, canonical))。canonical 为 4 行:X-Cbc-Timestamp、X-Cbc-Nonce、RSA-SHA256、请求 body 原始字节的 SHA-256 小写 hex,用 \n 连接,末尾不加换行。

请求参数

参数名 必选 类型 说明
data 是 object 如下
data.trade_id 是 string 商户提现单号,即提现申请时的 trade_id
data.user_id 是 string 订单所属用户
data.coin 是 string 币种标识,小写
data.address 是 string 提现地址
data.amount 是 string 提现金额,十进制字符串,与提现结果通知中的 amount 一致

商户校验步骤

  1. 4 个 Header 齐全,X-Cbc-Sign-Alg 为 RSA-SHA256;
  2. X-Cbc-Timestamp 与当前时间相差不超过 300 秒;
  3. 用平台风控公钥按 canonical 验签,参与摘要的必须是收到的 body 原始字节;
  4. nonce 在 300 秒内未出现过(建议缓存 660 秒);
  5. 以上任一失败,返回 status=5400,平台稍后会重新请求;
  6. 验签通过后再解析 body,按 trade_id 查本地提现单,逐项核对 user_id、coin、address、amount 后返回结果。

返回参数说明

参数名 类型 说明
status integer 复核结果,取值与 v1 相同:200 通过,2001 等待审核,5400 签名验证不通过(含时间戳超窗、nonce 重复),5402 订单号不存在,5001 trade_id 有差异,5002 金额不对,5003 user_id 不对,5004 地址不对,5005 币种不对,5006 订单拒绝,5007 其他
msg string 可选,结果说明
data object
data.trade_id string 原样回传请求中的 trade_id

响应签名使用商户风控私钥,Header 与请求相同(X-Cbc-Timestamp、X-Cbc-Nonce、X-Cbc-Sign-Alg、X-Cbc-Signature)。canonical 为 4 行:响应头的 timestamp、nonce、RSA-SHA256、响应 body 原始字节的 SHA-256 小写 hex。整个响应 body 都在签名范围内。

兑换订单二次复核

请求示例:

POST <商户提供的兑换复核地址>
Content-Type: application/json
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"data":{"trade_id":"E202610210001","user_id":"10086","source_coin":"eth","target_coin":"usdt_erc20","amount":"2"}}

请求待签串(4 行,\n 连接,末尾无换行):

1792382460
9f2c4e6a8b0d1f3e5a7c9e1b3d5f7a9c
RSA-SHA256
<请求 body 原始字节的 SHA-256 小写 hex>

商户处理示例:

// riskPlatformKey 为平台风控公钥,riskPrivateKey 为商户风控私钥(cbc.ParsePublicKey / cbc.ParsePrivateKey 解析)
http.HandleFunc("/risk/exchange/check", func(w http.ResponseWriter, r *http.Request) {
    body, _ := io.ReadAll(r.Body)
    status, tradeID := 5400, ""
    if err := cbc.VerifyBody(r.Header, body, riskPlatformKey, true); err == nil {
        // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地兑换单,得出 status
        var req struct {
            Data struct {
                TradeID string `json:"trade_id"`
            } `json:"data"`
        }
        json.Unmarshal(body, &req)
        tradeID, status = req.Data.TradeID, 200
    }
    out, _ := json.Marshal(map[string]any{"status": status, "data": map[string]string{"trade_id": tradeID}})
    headers, _ := cbc.SignBody(out, riskPrivateKey)
    for k, v := range headers {
        w.Header().Set(k, v)
    }
    w.Header().Set("Content-Type", "application/json")
    w.Write(out)
})
// $riskPlatformPublicKeyPem 为平台风控公钥,$riskPrivateKeyPem 为商户风控私钥
$body = file_get_contents('php://input');
$headers = array_change_key_case(getallheaders(), CASE_LOWER);
$status = 5400;
$tradeId = '';
try {
    CbcClient::verifyBody($headers, $body, $riskPlatformPublicKeyPem, true);
    // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地兑换单,得出 status
    $req = json_decode($body, true);
    $tradeId = $req['data']['trade_id'];
    $status = 200;
} catch (RuntimeException $e) {
    // 验签失败返回 5400,平台稍后重试
}
$out = json_encode(['status' => $status, 'data' => ['trade_id' => $tradeId]]);
foreach (CbcClient::signBody($out, $riskPrivateKeyPem) as $k => $v) {
    header("$k: $v");
}
header('Content-Type: application/json');
echo $out;
// riskPlatformPublicKeyPem 为平台风控公钥,riskPrivateKeyPem 为商户风控私钥
app.post('/risk/exchange/check', express.raw({ type: 'application/json' }), (req, res) => {
  let status = 5400;
  let tradeId = '';
  try {
    verifyBody((name) => req.get(name), req.body, riskPlatformPublicKeyPem, true);
    // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地兑换单,得出 status
    tradeId = JSON.parse(req.body).data.trade_id;
    status = 200;
  } catch (e) {
    // 验签失败返回 5400,平台稍后重试
  }
  const out = Buffer.from(JSON.stringify({ status, data: { trade_id: tradeId } }));
  res.set(signBody(out, riskPrivateKeyPem)).type('application/json').send(out);
});
// riskPlatformKey 为平台风控公钥,riskPrivateKey 为商户风控私钥;parseTradeId 用项目里的 JSON 库取 data.trade_id
@PostMapping(value = "/risk/exchange/check", produces = "application/json")
public ResponseEntity<byte[]> exchangeCheck(@RequestHeader HttpHeaders headers, @RequestBody byte[] body) throws Exception {
    Map<String, String> sig = new HashMap<>();
    for (String name : new String[]{"X-Cbc-Timestamp", "X-Cbc-Nonce", "X-Cbc-Sign-Alg", "X-Cbc-Signature"}) {
        sig.put(name, headers.getFirst(name));
    }
    int status = 5400;
    String tradeId = "";
    try {
        CbcClient.verifyBody(sig, body, riskPlatformKey, true);
        // 按 X-Cbc-Nonce 去重,再按 trade_id 核对本地兑换单,得出 status
        tradeId = parseTradeId(body);
        status = 200;
    } catch (Exception e) {
        // 验签失败返回 5400,平台稍后重试
    }
    byte[] out = CbcClient.toJson(Map.of("status", status, "data", Map.of("trade_id", tradeId)))
            .getBytes(StandardCharsets.UTF_8);
    HttpHeaders respHeaders = new HttpHeaders();
    CbcClient.signBody(out, riskPrivateKey).forEach(respHeaders::set);
    return ResponseEntity.ok().headers(respHeaders).body(out);
}

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"status":200,"msg":"success","data":{"trade_id":"E202610210001"}}

HTTP Request

POST 具体回调地址,由商户提供给平台方

请求 Header

参数名 说明
X-Cbc-Timestamp 请求时间,Unix 秒
X-Cbc-Nonce 随机串,32 位小写 hex,每次请求都不同
X-Cbc-Sign-Alg 固定 RSA-SHA256
X-Cbc-Signature 对 canonical 的签名,Base64 标准编码

签名 = Base64(RSA_PKCS1v15_Sign(平台风控私钥, SHA-256, canonical))。canonical 为 4 行:X-Cbc-Timestamp、X-Cbc-Nonce、RSA-SHA256、请求 body 原始字节的 SHA-256 小写 hex,用 \n 连接,末尾不加换行。

请求参数

参数名 必选 类型 说明
data 是 object 如下
data.trade_id 是 string 商户兑换单号,即兑换申请时的 trade_id
data.user_id 是 string 订单所属用户
data.source_coin 是 string 兑换币,小写,以平台提供的币种为准
data.target_coin 是 string 兑换目标币,小写,以平台提供的币种为准
data.amount 是 string 兑换数量,十进制字符串,不补尾零。请按数值比较,不要按字符串比较

商户校验步骤

  1. 4 个 Header 齐全,X-Cbc-Sign-Alg 为 RSA-SHA256;
  2. X-Cbc-Timestamp 与当前时间相差不超过 300 秒;
  3. 用平台风控公钥按 canonical 验签,参与摘要的必须是收到的 body 原始字节;
  4. nonce 在 300 秒内未出现过(建议缓存 660 秒);
  5. 以上任一失败,返回 status=5400,平台稍后会重新请求;
  6. 验签通过后再解析 body,按 trade_id 查本地兑换单,逐项核对 user_id、source_coin、target_coin、amount 后返回结果。

返回参数说明

参数名 类型 说明
status integer 复核结果:200 通过,2001 等待审核,5400 签名验证不通过(含时间戳超窗、nonce 重复),5402 订单号不存在,5001 trade_id 有差异,5002 金额不对,5003 user_id 不对,5005 币种不对,5006 订单拒绝,5007 其他
msg string 可选,结果说明
data object
data.trade_id string 原样回传请求中的 trade_id

响应签名使用商户风控私钥,Header 与请求相同(X-Cbc-Timestamp、X-Cbc-Nonce、X-Cbc-Sign-Alg、X-Cbc-Signature)。canonical 为 4 行:响应头的 timestamp、nonce、RSA-SHA256、响应 body 原始字节的 SHA-256 小写 hex。整个响应 body 都在签名范围内。

MPC订单复核接口

$url = "http://*****/mpc/order/check";
$header = [
  'Content-Type:application/json',
];
$params = [
    "data" => [
        "amount" => 2.00000000,
        "coin_symbol" => "usdt_trc20",
        "address" => "TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
        "user_id" => "1",
        "order_id" => "1394934189494173697",
        "timestamp" => 1621493658
    ],
    "sign" => "dLtK+uiPcnxt2ACKMbBqQ6wI5ttAvesOHzK5ybVID1R6hqYPDTkagl7Tsjr5iLJafehcSLTZyJLtCRI8O2CtIWQUUroGXBneHZC486NUi/4FMOQs0FaAgm17pWlbhX5/96cWXXXMVeoe3IZFKaFNYSWaA14v3RcdDU6QDE/9ixGiSJ0DIxm9NKA0+RkbIFbyYeuFn8d63OcjmUhv7tsOE6rKCc3Q2yi7Qe9i6BNAQFYMFATztb18MsxsBHKUxNqklqyVnl0ofETAHmQhfOHLmungOJQnOqAAuwfmRtg50Qci5F+R2mXeqjmIXko/u3E+DLYW1ygDBp3afKZmU4PwmA=="
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
$return = curl_exec($ch);

print_r($return); 
var url = "http://*****/mpc/order/check"
data := map[string]interface{}{
    "data": map[string]string{
        "amount":"2.00000000",
        "coin_symbol":"usdt_trc20",
        "address":"TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
        "user_id":"1",
        "order_id":"1394934189494173697",
        "timestamp":"1621493658",
    },
    "sign": "OTA8utI8y8G93p7RPCyb4qIilFQ0B4Aq4iUjhaXWK9m2kgektqlHOASDKXT2VE7NPNysrGycYlVfjDR2WGZn1G66phHo3qa9CcCNpG9klOBEuBEMjiVbb/d8AXcxEzvQr9OCwNsikyxonyzLiY/lsNHeGm9cC5eRvlNLdUSVBipH+ajPd0lDHCayZPs1eCMfbm/xnf8e2lfy6z0UPOpHGfyX/0+hz99Ir5Xnx+0sBBzyZZJxKm4ROid5aDv/9m9guILpURae+Yw/IrkYF4uAKGX+/44cBvtTRQSdX76CAOBSiywZa6BAgDYBLRtkAPM+i+vwNzFBovqHUvI+4Ponaw==",
}
dataType, _ := json.Marshal(data)
resp, err := http.Post(url, "application/json", strings.NewReader(string(dataType)))
if err != nil {
  fmt.Println(err)
}
defer resp.Body.Close()

body, err := ioutil.ReadAll(resp.Body)
if err != nil {
  fmt.Println(err)
}

fmt.Println(string(body))
let HTTP = require('http')
let postData = {
  "data": {
    "amount":"2.00000000",
    "coin_symbol":"usdt_trc20",
    "address":"TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
    "user_id":"1",
    "order_id":"1394934189494173697",
    "timestamp":"1621493658",
  },
  "sign": "OTA8utI8y8G93p7RPCyb4qIilFQ0B4Aq4iUjhaXWK9m2kgektqlHOASDKXT2VE7NPNysrGycYlVfjDR2WGZn1G66phHo3qa9CcCNpG9klOBEuBEMjiVbb/d8AXcxEzvQr9OCwNsikyxonyzLiY/lsNHeGm9cC5eRvlNLdUSVBipH+ajPd0lDHCayZPs1eCMfbm/xnf8e2lfy6z0UPOpHGfyX/0+hz99Ir5Xnx+0sBBzyZZJxKm4ROid5aDv/9m9guILpURae+Yw/IrkYF4uAKGX+/44cBvtTRQSdX76CAOBSiywZa6BAgDYBLRtkAPM+i+vwNzFBovqHUvI+4Ponaw==",
};
let POST_OPTIONS = {
  port: 80,
  host: "api.xxxx.com",
  path: "/mpc/order/check",
  method: 'POST',
  headers: {
    "Content-Type": "application/json; charset=utf-8"
  }
};

const REQUEST = HTTP.request(POST_OPTIONS,function (res) {
  let data = []
  res.on('data', chunk => {
    data.push(...chunk)
  })
  res.on('end', () => {
    let _date = JSON.parse( new TextDecoder().decode(new Uint8Array(data)))
    console.log(_date)
  })
});

REQUEST.setTimeout(6000)
REQUEST.write(JSON.stringify(postData), 'utf8')
REQUEST.end()
public static void main() {
    String priKey = "MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCtdgvcfozY7fe/x6UlXR/Fff8+wX++CiG05YVRafDe90O8y5KJAMZ156TgajEUXSRyKZqASz7iVoMAcu5FqfK1KuOOdjTAg0LFe/twIZvKmAqHcCSS2pjUXk0fTpZEgQ5lmDCK12Mg07YXvr+BeHjF+kBpwRJMPMG/+DGBDYNFNeRSJqWyopt6yyF528soAykHIUQ7TTultJV5IPCrvjRQQrGdJ/QtCdE0vZg+tA09nFN7AqgraU99kIvzyS0sqysj+pP1SJRmTRSGtlVAO3mILfkXOekZl1KD60G7CF+7BIaaW83FPD55tZhAGhnbLMYyiq7OiIyU61LTRcNSaJ0tAgMBAAECggEBAIGgGKcSzxCBbMYdXLV6TPbZ/HeaRGrwyVWUu7cmc0E8CJu6iWvmb2jGzbiCwuCT5luF6ZZ8JKchvU4FlTfsE5r9TQY2IZ/Ht4s65qBaDUEts5iY3kv8HX9+ZSXDJZpV0ztqqsPmx4ZNj+NYwWXwcFiKdb5R8OmV8bgSsnPddD6wFhwewglUOBPRAjropHE4sqk1Vam6q1MlFq5kiekMn/CItyFYFFzST/ruqAtVTp7YIvazAMrfCKH+pvXWk6pYNHZmL/JZey0GglRyJ1nItiqL33X8Lji056FcbAclidq022h/KPLEJpZk6irWqYdqYZeF6YMLHtdZFDkTZ/hXY+UCgYEA5i794UTQ1Kd6K+iui/S8K5H8nGdiXb3+uZ5j5VKYfbRmzXhAdVYisYe8czeTECxhH+MeHgM4tLR4ifx9q60ylvZxl9Fav1p6EaE36YcvGVmpm7Gm3q6QDDBa4gB+X9u7CxCS4LpotV917YS1QvOIF9lnRonSj1zNzFtbXkywrN8CgYEAwOpx/mR40ZvgZxNCq9DsIdrSZYAFFKpw0xy0OtF1PpuwMaREoRabnlVw6Bb3Hofg50XA3JxemzAX6fB92ee+NfXfeL4UtC4vG1K9JyiXHtHq8p9Uw2W03ehIEeNa3xdoRRnLmD4VUpyfL19ViE2+7TM1Gd3TogjDT+AMOCSuq3MCgYBsurPH7gaq/LVT+mRAzgj4l8v4YUlwuGeTbIMJdvt7HXUWB4CDLH3U2CYnUpAQKrZyJok6ahEmIr1xiKggKP7lmmHL8eNo0icpHrtXfzi7Q8Q/PCpzs4dtioXTjaIkS5nNvzVyG/uL+RyuZmpsxrZ5dYM4KbAhchfwORMutxEZhwKBgQC5zpVw4jCEItBmNuTWO+nTScGvxTgfiXIVw+XLaQa2AJoZlhAL34yPWdffko79tv3lgweY9HsimZXO2rU8dbp8mo5c6ydhy8HPXUeWOcAkDSdv/ApWENW9jgYsRIC3swHY3Fl+Dv3Wjce8huQI3mjwaYvRmBhIToxfmHnscVhTBQKBgB9uciEHfz8hMI7ePrPo2PkyK/RbJDm3HnuWE2lFBp7MOUMlh53MXwv4dIRaYMbRrFuN1UIKEFxuKhWwTHSzZJufk/UENrha/81fpj2BoFsAKkEunKeETvaIh6fZSjec16h2+zxbzwkdS6b+yIYkSlaoAxmDYrMtae0C8G4e0YS9";
    String pubKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArXYL3H6M2O33v8elJV0fxX3/PsF/vgohtOWFUWnw3vdDvMuSiQDGdeek4GoxFF0kcimagEs+4laDAHLuRanytSrjjnY0wINCxXv7cCGbypgKh3AkktqY1F5NH06WRIEOZZgwitdjINO2F76/gXh4xfpAacESTDzBv/gxgQ2DRTXkUialsqKbesshedvLKAMpByFEO007pbSVeSDwq740UEKxnSf0LQnRNL2YPrQNPZxTewKoK2lPfZCL88ktLKsrI/qT9UiUZk0UhrZVQDt5iC35FznpGZdSg+tBuwhfuwSGmlvNxTw+ebWYQBoZ2yzGMoquzoiMlOtS00XDUmidLQIDAQAB";
    rsaSigner signer = new rsaSigner();

    Map<String, Object> data = new HashMap<>();
    data.put("amount", "2.00000000");
    data.put("coin_symbol", "usdt_trc20");
    data.put("address", "TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi");
    data.put("user_id", "1");
    data.put("order_id", "1394934189494173697");
    data.put("timestamp", "1621493658");

    try {
        Map<String, Object> params = new HashMap<>();
        params.put("data", data);
        params.put("sign", signer.genSign(data, priKey));

        Gson gson = new GsonBuilder().create();
        System.out.println("params = " + gson.toJson(params));

        String res;
        // platform request shop callback API
//            res = doPost("http://api.shophost.com/mpc/order/check", gson.toJson(params));
//            if (null == res) {
//                throw new RuntimeException("http error");
//            }

        // mock response from shop callback API
        {
            res = """
                    {
                      "status":200,
                      "data":{
                        "time":1620617260,
                        "trade_id":"202105101123221335892766889804"
                      },
                      "sign":"YbRyMoUmsCxLbWopD2JD5EZqkT+pIRARsdTSFo+WyhebOMP/TZ96zV/vy4CYn+9gk6nJ55acFnqSO78N4/uemiOyBgE+a8SaIjutc+kFCWGaCorboy9alFBFUbYPvHvFFKHNFJx19Z2cyv9uceGdOdz09g0OBgp8bTyfkCUNrhbUmut2M2S2ixSH3wSefqUq2SUpohb5hlD6tOsyO3JfZr7M/16aiRGcEye2XglsOMFTO5XRkj4hwHKB+nHacttvuZKnGH67ELyoajCc+ef1DkmzmO3P7vFLIuVtVXQ2FPlXVkzCR/+VesyDOpYogHwqyR1BzCCSzxpbZ/aFc/uANg=="
                    }
                    """;
        }

        System.out.println("response = " + res);

        JsonParser jp = new JsonParser();
        JsonObject resEle = jp.parse(res).getAsJsonObject();
        boolean retSignOK = signer.verifySign(resEle.get("data"), resEle.get("sign").getAsString(), pubKey);
        if (!retSignOK) {
            throw new RuntimeException("verify response sign fail");
        }

    } catch (Exception e) {
        e.printStackTrace();
    }

    System.out.println("OK");
}

返回结果示例:

{
  "status":200,
  "data":{
    "is_valid": 1,
    "timestamp":1620617260,
    "order_id":"1394934189494173697"
  },
  "sign":"YbRyMoUmsCxLbWopD2JD5EZqkT+pIRARsdTSFo+WyhebOMP/TZ96zV/vy4CYn+9gk6nJ55acFnqSO78N4/uemiOyBgE+a8SaIjutc+kFCWGaCorboy9alFBFUbYPvHvFFKHNFJx19Z2cyv9uceGdOdz09g0OBgp8bTyfkCUNrhbUmut2M2S2ixSH3wSefqUq2SUpohb5hlD6tOsyO3JfZr7M/16aiRGcEye2XglsOMFTO5XRkj4hwHKB+nHacttvuZKnGH67ELyoajCc+ef1DkmzmO3P7vFLIuVtVXQ2FPlXVkzCR/+VesyDOpYogHwqyR1BzCCSzxpbZ/aFc/uANg=="
}

HTTP Request

POST 具体回调地址,由商户提供给平台方

请求参数

参数名 必选 类型 说明
data 否 string 如下
data.order_id 是 string 商户端交易唯一ID(提现时的 trade_id)
data.user_id 是 string 订单所属用户
data.coin_symbol 是 string 币种名称小写,以平台提供的币种为准
data.address 是 string 提现地址
data.amount 是 string 提现金额
data.timestamp 是 integer 当前时间戳
sign 是 string 对data内数据签名

返回参数说明

参数名 类型 说明
status integer 200 通过,2001 等待审核,5400 签名验证不通过,5401 时间小于30s,5402 订单号不存在,5001 平台order_id有差异,5002 金额不对,5003 用户uid不对,5004 地址不对,5005 币种symbol不对,5006 订单拒绝,5007 其他,描述信息可自行扩展
msg string 状态描述
data object
data.is_valid integer 1 通过;2 不通过
data.order_id string 订单号
data.timestamp integer 当前时间
sign string 签名-对响应参数中的data字段内容的签名

CoSigner-MPC订单复核接口

$url = "http://*****/cs_mpc/order/check";
$header = [
  'Content-Type:application/json',
];
$params = [
    "data" => [
        "amount" => 2.00000000,
        "coin" => "usdt_trc20",
        "address" => "TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
        "user_id" => "1",
        "trade_id" => "1394934189494173697",
        "timestamp" => 1621493658
    ],
    "sign" => "dLtK+uiPcnxt2ACKMbBqQ6wI5ttAvesOHzK5ybVID1R6hqYPDTkagl7Tsjr5iLJafehcSLTZyJLtCRI8O2CtIWQUUroGXBneHZC486NUi/4FMOQs0FaAgm17pWlbhX5/96cWXXXMVeoe3IZFKaFNYSWaA14v3RcdDU6QDE/9ixGiSJ0DIxm9NKA0+RkbIFbyYeuFn8d63OcjmUhv7tsOE6rKCc3Q2yi7Qe9i6BNAQFYMFATztb18MsxsBHKUxNqklqyVnl0ofETAHmQhfOHLmungOJQnOqAAuwfmRtg50Qci5F+R2mXeqjmIXko/u3E+DLYW1ygDBp3afKZmU4PwmA=="
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
$return = curl_exec($ch);

print_r($return); 
var url = "http://*****/cs_mpc/order/check"
data := map[string]interface{}{
    "data": map[string]string{
        "amount":"2.00000000",
        "coin":"usdt_trc20",
        "address":"TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
        "user_id":"1",
        "trade_id":"1394934189494173697",
        "timestamp":"1621493658",
    },
    "sign": "OTA8utI8y8G93p7RPCyb4qIilFQ0B4Aq4iUjhaXWK9m2kgektqlHOASDKXT2VE7NPNysrGycYlVfjDR2WGZn1G66phHo3qa9CcCNpG9klOBEuBEMjiVbb/d8AXcxEzvQr9OCwNsikyxonyzLiY/lsNHeGm9cC5eRvlNLdUSVBipH+ajPd0lDHCayZPs1eCMfbm/xnf8e2lfy6z0UPOpHGfyX/0+hz99Ir5Xnx+0sBBzyZZJxKm4ROid5aDv/9m9guILpURae+Yw/IrkYF4uAKGX+/44cBvtTRQSdX76CAOBSiywZa6BAgDYBLRtkAPM+i+vwNzFBovqHUvI+4Ponaw==",
}
dataType, _ := json.Marshal(data)
resp, err := http.Post(url, "application/json", strings.NewReader(string(dataType)))
if err != nil {
  fmt.Println(err)
}
defer resp.Body.Close()

body, err := ioutil.ReadAll(resp.Body)
if err != nil {
  fmt.Println(err)
}

fmt.Println(string(body))
let HTTP = require('http')
let postData = {
  "data": {
    "amount":"2.00000000",
    "coin":"usdt_trc20",
    "address":"TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi",
    "user_id":"1",
    "trade_id":"1394934189494173697",
    "timestamp":"1621493658",
  },
  "sign": "OTA8utI8y8G93p7RPCyb4qIilFQ0B4Aq4iUjhaXWK9m2kgektqlHOASDKXT2VE7NPNysrGycYlVfjDR2WGZn1G66phHo3qa9CcCNpG9klOBEuBEMjiVbb/d8AXcxEzvQr9OCwNsikyxonyzLiY/lsNHeGm9cC5eRvlNLdUSVBipH+ajPd0lDHCayZPs1eCMfbm/xnf8e2lfy6z0UPOpHGfyX/0+hz99Ir5Xnx+0sBBzyZZJxKm4ROid5aDv/9m9guILpURae+Yw/IrkYF4uAKGX+/44cBvtTRQSdX76CAOBSiywZa6BAgDYBLRtkAPM+i+vwNzFBovqHUvI+4Ponaw==",
};
let POST_OPTIONS = {
  port: 80,
  host: "api.xxxx.com",
  path: "/cs_mpc/order/check",
  method: 'POST',
  headers: {
    "Content-Type": "application/json; charset=utf-8"
  }
};

const REQUEST = HTTP.request(POST_OPTIONS,function (res) {
  let data = []
  res.on('data', chunk => {
    data.push(...chunk)
  })
  res.on('end', () => {
    let _date = JSON.parse( new TextDecoder().decode(new Uint8Array(data)))
    console.log(_date)
  })
});

REQUEST.setTimeout(6000)
REQUEST.write(JSON.stringify(postData), 'utf8')
REQUEST.end()
public static void main() {
    String priKey = "MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCtdgvcfozY7fe/x6UlXR/Fff8+wX++CiG05YVRafDe90O8y5KJAMZ156TgajEUXSRyKZqASz7iVoMAcu5FqfK1KuOOdjTAg0LFe/twIZvKmAqHcCSS2pjUXk0fTpZEgQ5lmDCK12Mg07YXvr+BeHjF+kBpwRJMPMG/+DGBDYNFNeRSJqWyopt6yyF528soAykHIUQ7TTultJV5IPCrvjRQQrGdJ/QtCdE0vZg+tA09nFN7AqgraU99kIvzyS0sqysj+pP1SJRmTRSGtlVAO3mILfkXOekZl1KD60G7CF+7BIaaW83FPD55tZhAGhnbLMYyiq7OiIyU61LTRcNSaJ0tAgMBAAECggEBAIGgGKcSzxCBbMYdXLV6TPbZ/HeaRGrwyVWUu7cmc0E8CJu6iWvmb2jGzbiCwuCT5luF6ZZ8JKchvU4FlTfsE5r9TQY2IZ/Ht4s65qBaDUEts5iY3kv8HX9+ZSXDJZpV0ztqqsPmx4ZNj+NYwWXwcFiKdb5R8OmV8bgSsnPddD6wFhwewglUOBPRAjropHE4sqk1Vam6q1MlFq5kiekMn/CItyFYFFzST/ruqAtVTp7YIvazAMrfCKH+pvXWk6pYNHZmL/JZey0GglRyJ1nItiqL33X8Lji056FcbAclidq022h/KPLEJpZk6irWqYdqYZeF6YMLHtdZFDkTZ/hXY+UCgYEA5i794UTQ1Kd6K+iui/S8K5H8nGdiXb3+uZ5j5VKYfbRmzXhAdVYisYe8czeTECxhH+MeHgM4tLR4ifx9q60ylvZxl9Fav1p6EaE36YcvGVmpm7Gm3q6QDDBa4gB+X9u7CxCS4LpotV917YS1QvOIF9lnRonSj1zNzFtbXkywrN8CgYEAwOpx/mR40ZvgZxNCq9DsIdrSZYAFFKpw0xy0OtF1PpuwMaREoRabnlVw6Bb3Hofg50XA3JxemzAX6fB92ee+NfXfeL4UtC4vG1K9JyiXHtHq8p9Uw2W03ehIEeNa3xdoRRnLmD4VUpyfL19ViE2+7TM1Gd3TogjDT+AMOCSuq3MCgYBsurPH7gaq/LVT+mRAzgj4l8v4YUlwuGeTbIMJdvt7HXUWB4CDLH3U2CYnUpAQKrZyJok6ahEmIr1xiKggKP7lmmHL8eNo0icpHrtXfzi7Q8Q/PCpzs4dtioXTjaIkS5nNvzVyG/uL+RyuZmpsxrZ5dYM4KbAhchfwORMutxEZhwKBgQC5zpVw4jCEItBmNuTWO+nTScGvxTgfiXIVw+XLaQa2AJoZlhAL34yPWdffko79tv3lgweY9HsimZXO2rU8dbp8mo5c6ydhy8HPXUeWOcAkDSdv/ApWENW9jgYsRIC3swHY3Fl+Dv3Wjce8huQI3mjwaYvRmBhIToxfmHnscVhTBQKBgB9uciEHfz8hMI7ePrPo2PkyK/RbJDm3HnuWE2lFBp7MOUMlh53MXwv4dIRaYMbRrFuN1UIKEFxuKhWwTHSzZJufk/UENrha/81fpj2BoFsAKkEunKeETvaIh6fZSjec16h2+zxbzwkdS6b+yIYkSlaoAxmDYrMtae0C8G4e0YS9";
    String pubKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArXYL3H6M2O33v8elJV0fxX3/PsF/vgohtOWFUWnw3vdDvMuSiQDGdeek4GoxFF0kcimagEs+4laDAHLuRanytSrjjnY0wINCxXv7cCGbypgKh3AkktqY1F5NH06WRIEOZZgwitdjINO2F76/gXh4xfpAacESTDzBv/gxgQ2DRTXkUialsqKbesshedvLKAMpByFEO007pbSVeSDwq740UEKxnSf0LQnRNL2YPrQNPZxTewKoK2lPfZCL88ktLKsrI/qT9UiUZk0UhrZVQDt5iC35FznpGZdSg+tBuwhfuwSGmlvNxTw+ebWYQBoZ2yzGMoquzoiMlOtS00XDUmidLQIDAQAB";
    rsaSigner signer = new rsaSigner();

    Map<String, Object> data = new HashMap<>();
    data.put("amount", "2.00000000");
    data.put("coin", "usdt_trc20");
    data.put("address", "TLhdZuFU1fDPnzxPoXfJ6WZZMpKzY15DUi");
    data.put("user_id", "1");
    data.put("trade_id", "1394934189494173697");
    data.put("timestamp", "1621493658");

    try {
        Map<String, Object> params = new HashMap<>();
        params.put("data", data);
        params.put("sign", signer.genSign(data, priKey));

        Gson gson = new GsonBuilder().create();
        System.out.println("params = " + gson.toJson(params));

        String res;
        // platform request shop callback API
//            res = doPost("http://api.shophost.com/cs_mpc/order/check", gson.toJson(params));
//            if (null == res) {
//                throw new RuntimeException("http error");
//            }

        // mock response from shop callback API
        {
            res = """
                    {
                      "status":200,
                      "data":{
                        "time":1620617260,
                        "trade_id":"202105101123221335892766889804"
                      },
                      "sign":"YbRyMoUmsCxLbWopD2JD5EZqkT+pIRARsdTSFo+WyhebOMP/TZ96zV/vy4CYn+9gk6nJ55acFnqSO78N4/uemiOyBgE+a8SaIjutc+kFCWGaCorboy9alFBFUbYPvHvFFKHNFJx19Z2cyv9uceGdOdz09g0OBgp8bTyfkCUNrhbUmut2M2S2ixSH3wSefqUq2SUpohb5hlD6tOsyO3JfZr7M/16aiRGcEye2XglsOMFTO5XRkj4hwHKB+nHacttvuZKnGH67ELyoajCc+ef1DkmzmO3P7vFLIuVtVXQ2FPlXVkzCR/+VesyDOpYogHwqyR1BzCCSzxpbZ/aFc/uANg=="
                    }
                    """;
        }

        System.out.println("response = " + res);

        JsonParser jp = new JsonParser();
        JsonObject resEle = jp.parse(res).getAsJsonObject();
        boolean retSignOK = signer.verifySign(resEle.get("data"), resEle.get("sign").getAsString(), pubKey);
        if (!retSignOK) {
            throw new RuntimeException("verify response sign fail");
        }

    } catch (Exception e) {
        e.printStackTrace();
    }

    System.out.println("OK");
}

返回结果示例:

{
  "status":200,
  "data":{
    "is_valid": 1,
    "timestamp":1620617260,
    "trade_id":"1394934189494173697"
  },
  "sign":"YbRyMoUmsCxLbWopD2JD5EZqkT+pIRARsdTSFo+WyhebOMP/TZ96zV/vy4CYn+9gk6nJ55acFnqSO78N4/uemiOyBgE+a8SaIjutc+kFCWGaCorboy9alFBFUbYPvHvFFKHNFJx19Z2cyv9uceGdOdz09g0OBgp8bTyfkCUNrhbUmut2M2S2ixSH3wSefqUq2SUpohb5hlD6tOsyO3JfZr7M/16aiRGcEye2XglsOMFTO5XRkj4hwHKB+nHacttvuZKnGH67ELyoajCc+ef1DkmzmO3P7vFLIuVtVXQ2FPlXVkzCR/+VesyDOpYogHwqyR1BzCCSzxpbZ/aFc/uANg=="
}

HTTP Request

POST 具体回调地址,由商户提供给平台方

请求参数

参数名 必选 类型 说明
data 否 string 如下
data.trade_id 是 string 商户端交易唯一ID(提现时的 trade_id)
data.user_id 是 string 订单所属用户
data.coin 是 string 币种名称小写,以平台提供的币种为准
data.address 是 string 提现地址
data.amount 是 string 提现金额
data.timestamp 是 integer 当前时间戳
sign 是 string 对data内数据签名

返回参数说明

参数名 类型 说明
status integer 200 通过,2001 等待审核,5400 签名验证不通过,5401 时间小于30s,5402 订单号不存在,5001 平台order_id有差异,5002 金额不对,5003 用户uid不对,5004 地址不对,5005 币种symbol不对,5006 订单拒绝,5007 其他,描述信息可自行扩展
msg string 状态描述
data object
data.is_valid integer 1 通过;2 不通过
data.trade_id string 商户端交易唯一ID
data.timestamp integer 当前时间
sign string 签名-对响应参数中的data字段内容的签名