查询协议API

请求地址

生产环境
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 固定为“CMCX” CMCX
商户分行号 branchNo String(6) M 商户分行号,4位数字 0755
商户号 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":"CMCX",
        "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
协议号 agrNo String(32) M 客户协议号,成功交易返回 201606238888888
协议签约时间 userSignDateTime String(14) M 客户签订协议的时间
yyyyMMddHHmmss,成功交易返回
20160623101432
证件类型 userPidType String(1) M 证件类型 目前只有”1”,表示身份证 1
证件号hash值 userPidHash String(30) M 证件号映射的30位hash值,成功交易返回 501010131010181016101010101012
免密标识 noPwdPay String(1) M 免密标识,固定为”N”,表示不开通免密。 N

响应示例

1.正常json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "rspData":{
        "rspCode":"SUC0000",
        "rspMsg":"查询成功。",
        "dateTime":"20160623101430",
        "merchantSerialNo":"2016062310143088",
        "agrNo":"201606238888888",
        "userSignDateTime":"20160623101432",
        "userPidType":"1",
        "userPidHash":"501010131010181016101010101012",
        "noPwdPay":"N"
    }
}

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

agrNo=201606238888888&dateTime=20160623101430&merchantSerialNo=2016062310143088&noPwdPay=N&rspCode=SUC0000&rspMsg=查询成功。&userPidHash=501010131010181016101010101012&userPidType=1&userSignDateTime=20160623101432

2.异常jason报文组织

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

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

dateTime=20160817141537&rspCode=DCB0003&rspMsg=DCB0003 请求报文JSON格式错误!

错误码

错误码 描述 解决方案
DCB0001 DCB0001 贵方发送错误报文数太多,已被限制访问! 异常操作错误太多,请根据之前的错误反馈进行更改,限制将在一定时间后自动解除
DCB0002 DCB0002 请求报文数据不能为空! 输入参数jsonRequestData拼写正确,并且值非空
DCB0003 DCB0003 请求报文JSON格式错误! 输入参数jsonRequestData为合法的JSON格式
DCB0004 DCB0004 请求报文数据有误;请求报文长度过长 缩短输入参数jsonRequestData内容
DCB0004 DCB0004 请求报文数据有误:…… 错误消息有以下这些情况,请根据对应提示修改。
接口版本号version值不正确
参数编码charset值不正确
签名sign不能为空
签名算法signType值不正确
请求数据reqData不能为空
时间戳dateTime位数超长或者为0
时间戳dateTime不能为空
交易功能码txCode位数超长或者为0
交易功能码txCode不能为空
商户号merchantNo位数超长或者为0
商户号merchantNo不能为空
分行号branchNo位数超长或者为0
分行号branchNo不能为空
商户流水号merchantSerialNo位数超长或者为0
商户流水号merchantSerialNo不能为空
客户协议号agrNo位数超长或者为0
客户协议号agrNo不能为空
DCB0005 DCB0005 商户未开通接入平台功能;商户号:…… 请登录商户结账处理系统设置支付密钥
DCB0006 DCB0006 源IP地址不在商户IP白名单中;商户号:…;IP地址:… 商户需要提供IP添加到白名单中
DCB0007 DCB0007 调用功能不可用;调用功能代码:…… 调用的功能不支持,请输入支持的功能代码
DCB0008 DCB0008 签名验证失败:…… 错误消息有以下情况,请根据对应提示修改。
签名时间戳格式不正确!
签名时间错误,签名已经失效。
验签异常:……
DCB0010 DCB0010商户未设置密钥;商户号:…… 商户未正确开通接入平台功能,请按正规流程进行登记开通
DCB0017 DCB0017 与业务系统的通讯失败:…… 错误消息有以下情况,请稍后再试或联系招行相关技术支持人员。
[MIDServerComNP]业务系统繁忙
[MIDServerComNP]连接业务服务器失败:…
[MIDServerComNP]接收业务系统通讯报文头失败
[MIDServerComNP]接收业务系统通讯报文头非法
[MIDServerComNP]接收业务系统通讯报文包体长度不正确.[…]
[MIDServerComNP]与业务系统通讯异常:…
DCB0018 DCB0018 与业务系统的通讯异常:…… 错误消息有以下情况,请联系招行相关技术支持人员。解析中间业务平台返回报文失败
DCB0019 DCB0019 企业网银签名异常:…… 请联系招行相关技术支持人员
DCB0020 DCB0020 服务器繁忙,请稍后再试。 当前服务器负载达到上限,请稍后再试。
DCB0021 DCB0021解析返回报文失败 请联系招行相关技术支持人员
CMBMB97 请求参数错误 根据提示信息中括号里的内容,修改请求参数。
如:请求参数错误(商户交易日期),检查"商户交易日期"字段的内容是否正确
CMBMB33 客户协议不存在

关于网站迁移公告


为提供更优质的开发技术支持,本网站已于2019年8月12日正式迁移至新域名http://openhome.cmbchina.com/paynew/pay/Home,敬请访问并收藏。原网站域名已停止更新维护,请以新网站提供的文档信息为准。

由此给您带来的不便,敬请谅解。


招商银行一网通支付技术支持小组

2019年8月12日