招商银行 -- 开放文档

请求地址

生产环境
https://b2b.cmbchina.com/CmbBank_B2B/UI/NetPay/DoBusiness.ashx

测试环境
http://121.15.180.72/CmbBank_B2B/UI/NetPay/DoBusiness.ashx

请求报文

报文的参数名：jsonRequestData，参数值JSON格式见下表

参数名称	JSON键值	类型(长度)	必填	描述	示例
接口版本号	version	String(3)	M	固定为”1.0”	1.0
参数编码	charset	String(8)	M	固定为“UTF-8”	UTF-8
报文签名	sign	String	M	对reqData内的数据进行签名
签名算法	signType	String	M	固定为“SHA-256”	SHA-256
请求数据	reqData
请求时间	dateTime	String(14)	M	商户发起该请求的当前时间，精确到秒格式:yyyyMMddHHmmss	20160623101430
交易码	txCode	String	M	固定为“CMQX”	CMQX
商户分行号	branchNo	String(6)	M	商户分行号，6位数字	002346
商户号	merchantNo	String(6)	M	商户号，6位数字	000054
商户流水号	merchantSerialNo	String(20)	M	商户做此查询请求的流水号	2016062310143088
协议号	agrNo	String(32)	M	客户签约的协议号	201606238888888

请求示例

1.json报文组织:

{ 
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "reqData":{
        "dateTime":"20160623101430",
        "txCode":"CMQX",
        "branchNo":"0755",
        "merchantNo":"002346",
        "merchantSerialNo":"2016062310143088",
        "agrNo":"201606238888888"
    }
}

2.表单组织：

<form action="请求地址" method="post" />
    <input type="hidden" name="jsonRequestData" value='以上json字符串' />
    <input type="hidden" name="charset" value='UTF-8' />
</form>

3.待签名字符串示例（未包含支付密钥）：

agrNo=201606238888888&branchNo=0755&dateTime=20160623101430&merchantNo=002346&merchantSerialNo=2016062310143088

响应报文

参数名称	JSON键值	类型(长度)	必填	描述	示例
接口版本号	version	String(3)	M	固定为”1.0”	1.0
参数编码	charset	String(8)	M	固定为“UTF-8”	UTF-8
报文签名	sign	String	M	使用商户支付密钥对rspData内的数据进行验签
签名算法	signType	String	M	固定为“SHA-256”	SHA-256
应答数据	rspData
处理结果	rspCode	String	M	SUC0000：请求处理成功其他:请求处理失败	SUC0000
详细信息	rspMsg	String	C	失败时返回具体失败原因
响应时间	dateTime	String(14)	M	银行返回该数据的时间。格式：yyyyMMddHHmmss	20160623101430
商户流水号	merchantSerialNo	String(20)	M	原样返回商户做请求时的流水号	2016062310143088
银行流水号	bankSerialNo	String(30)	M	银行处理本请求的流水号	2016062310143099

响应示例

1.正常json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "rspData":{
        "rspCode":"SUC0000",
        "rspMsg":"取消成功。",
        "dateTime":"20160623101430",
        "merchantSerialNo":"2016062310143088",
        "bankSerialNo":"2016062310143099"
    }
}

待验签字符串(未包含支付密钥)：

bankSerialNo=2016062310143099&dateTime=20160623101430&merchantSerialNo=2016062310143088&rspCode=SUC0000&rspMsg=取消成功。

2.异常jason报文组织

{
    "version":"1.0",
	"charset":"UTF-8",
	"sign":"见签名处理章节",
	"signType":"SHA-256",
	"rspData":{
		"rspCode":"DCB0003",
		"rspMsg":"DCB0003 请求报文JSON格式错误!",
		"dateTime":"20160817141216"
    }
}