招商银行 -- 开放文档

请求地址

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

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

请求报文

报文的参数名：jsonRequestData，参数值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(4)	M	商户分行号，4位数字	0755
merchantNo	String(6)	M	商户号，6位数字	002346
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

响应报文

参数	类型(长度)	必填	描述	示例
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	M	详细信息,失败时返回具体失败原因
dateTime	String(14)	M	银行返回该数据的时间格式：yyyyMMddHHmmss	20160623101430
merchantSerialNo	String(20)	M	原样返回商户做请求时的流水号	2016062310143088
bankSerialNo	String(30)	M	银行处理本请求的流水号	2016062310143099

响应示例

1.正常json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "rspData":{
        "rspCode":"SUC0000",
        "rspMsg":"取消成功。",
        "dateTime":"20160623101430",
        "merchantSerialNo":"2016062310143088",
        "bankSerialNo":"2016062310143099"
    }
}

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

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

2.异常json报文组织：

{
    "version":"1.0",
    "charset":"UTF-8",
    "rspData":{
        "rspCode":"DCB0003",
		"rspMsg":"DCB0003 请求报文JSON格式错误!",
		"dateTime":"20160817141216"
    }
}