风控回调
提现订单二次复核
请求示例:
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"}}
- 商户提现订单风控二次复核接口
- 注意:平台给商户分配单独的风控公钥(与充值/提现公钥不同)
- 商户签名版本为 v2 时,平台按本节格式请求提现复核地址。签名版本仍为 v1 的商户见 v1 文档。
- 签名版本由平台按商户配置,同时控制全部结果通知、提现复核和兑换复核。请把回调接收端、提现复核接口和兑换复核接口(已开通兑换时)都改造完成后,再联系平台切换到 v2。
- 继续使用风控专用密钥对:平台用平台风控私钥签请求,商户用平台风控公钥验签;商户用商户风控私钥签响应,平台用商户风控公钥验签。v2 要求两把密钥都不少于 2048 位,公钥为 PKIX(
BEGIN PUBLIC KEY),私钥为 PKCS#8(BEGIN PRIVATE KEY)。 - 字段名与提现申请、提现结果通知一致:
order_id改为trade_id,coin_symbol改为coin;时间戳和签名移到 Header。
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.coin | 是 | string | 币种标识,小写 |
| data.address | 是 | string | 提现地址 |
| data.amount | 是 | string | 提现金额,十进制字符串,与提现结果通知中的 amount 一致 |
商户校验步骤
- 4 个 Header 齐全,
X-Cbc-Sign-Alg为RSA-SHA256; X-Cbc-Timestamp与当前时间相差不超过 300 秒;- 用平台风控公钥按 canonical 验签,参与摘要的必须是收到的 body 原始字节;
- nonce 在 300 秒内未出现过(建议缓存 660 秒);
- 以上任一失败,返回 status=5400,平台稍后会重新请求;
- 验签通过后再解析 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 都在签名范围内。
- 平台对响应的处理与 v1 相同:status=200 通过;status in (2001,5400) 稍后再次请求;其他 status 直接拒绝。
- 响应验签失败、超时或无法解析时,平台视为本次无结果,稍后再次请求,不会拒绝订单。
兑换订单二次复核
请求示例:
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"}}
- 商户兑换订单风控二次复核接口
- 注意:平台给商户分配单独的风控公钥(与充值/提现公钥不同)。兑换复核与提现订单二次复核共用同一套风控密钥对。
- 商户签名版本为 v2 时,平台按本节格式请求兑换复核地址。签名版本仍为 v1 的商户见 v1 文档。
- 签名版本由平台按商户配置,同时控制全部结果通知、提现复核和兑换复核。请把回调接收端、提现复核接口和兑换复核接口都改造完成后,再联系平台切换到 v2。
- 平台用平台风控私钥签请求,商户用平台风控公钥验签;商户用商户风控私钥签响应,平台用商户风控公钥验签。两把密钥都不少于 2048 位,公钥为 PKIX(
BEGIN PUBLIC KEY),私钥为 PKCS#8(BEGIN PRIVATE KEY)。 - 字段名与兑换申请、兑换结果通知一致;v1 中的
data.time移到 HeaderX-Cbc-Timestamp,签名移到 Header。
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 | 兑换数量,十进制字符串,不补尾零。请按数值比较,不要按字符串比较 |
商户校验步骤
- 4 个 Header 齐全,
X-Cbc-Sign-Alg为RSA-SHA256; X-Cbc-Timestamp与当前时间相差不超过 300 秒;- 用平台风控公钥按 canonical 验签,参与摘要的必须是收到的 body 原始字节;
- nonce 在 300 秒内未出现过(建议缓存 660 秒);
- 以上任一失败,返回 status=5400,平台稍后会重新请求;
- 验签通过后再解析 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 都在签名范围内。
- 平台对响应的处理:status=200 通过;status in (2001,5400) 稍后再次请求;其他 status 直接拒绝。
- 响应验签失败、超时或无法解析时,平台视为本次无结果,稍后再次请求,不会拒绝订单。
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=="
}
- 商户MPC提现订单复核接口
- 注意:平台给商户分配单独的MPC公钥(与充值/提现/风控公钥不同)
- 该接口使用单独的 rsa密钥对,商户和平台各生成一对rsa密钥
- 请求时,平台使用私钥签名生成sign,商户使用平台公钥解密验证签名
- 响应时,商户使用商户私钥加密签名,平台使用商户公钥解签
- 签名参数规则见v1 文档的签名规则
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=="
}
- 商户CoSigner-MPC提现订单复核接口
- 注意:平台给商户分配单独的CoSigner-MPC公钥(与充值/提现/风控公钥不同)
- 该接口使用单独的 rsa密钥对,商户和平台各生成一对rsa密钥
- 请求时,平台使用私钥签名生成sign,商户使用平台公钥解密验证签名
- 响应时,商户使用商户私钥加密签名,平台使用商户公钥解签
- 签名参数规则见v1 文档的签名规则
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字段内容的签名 |