APP支付

查询招行公钥API

请求地址

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

测试环境
http://mobiletest.cmburl.cn/CmbBank_B2B/UI/NetPay/DoBusiness.ashx

请求报文

报文的参数名:jsonRequestData,参数值JSON格式见下表

参数类型(长度)必填描述示例
versionString(3)M接口版本号,固定为”1.0”1.0
charsetString(8)M参数编码,固定为“UTF-8”UTF-8
signStringM报文签名,使用商户支付密钥对reqData内的数据进行签名
signTypeStringM签名算法,固定为”SHA-256”SHA-256
reqData请求数据
dateTimeString(14)M商户发起该请求的当前时间,精确到秒
格式:yyyyMMddHHmmss
20160623101430
txCodeStringM交易码,固定为“FBPK”FBPK
branchNoString(4)M商户分行号,4位数字0755
merchantNoString(6)M商户号,6位数字002346


请求示例

1.json报文组织:

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

2.表单组织:

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

3.待签名字符串(未包含支付密钥):

branchNo=0755&dateTime=20160623101430&merchantNo=002346&txCode=FBPK


响应报文

参数类型(长度)必填描述示例
versionString(3)M接口版本号,固定为”1.0”1.0
charsetString(8)M参数编码,固定为UTF-8UTF-8
signStringM报文签名,使用商户支付密钥对rspData内的数据进行验签
signTypeStringM签名算法,固定为”SHA-256”SHA-256
rspData应答数据
rspCodeStringM处理结果,SUC0000:请求处理成功
其他:请求处理失败
SUC0000
rspMsgStringM详细信息,失败时返回具体失败原因
fbPubKeyStringM用Base64编码的招行公钥
dateTimeString(14)M响应时间,银行返回该数据的时间
格式:yyyyMMddHHmmss
20160623101430


响应示例

1.正常json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "rspData":{                   
         "rspCode":"SUC0000",
         "rspMsg":"查询成功。",
         "fbPubKey":"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC8IdQSg5ryvST/IC5aAjNY5sFw+qhVkyFKGqQFQCZfXa9YqsbhZFhSBZHLUw+TIJO8axH7Sa+OM4AEmoddvaPrnXRB7XJmUQMXj77AnGStzzJfQddMGMJiKa4KT6wKsmQxjC3NdKrYLVQntb9qD+M3AqIK5WBvbh/ix5GUTmUQ+QIDAQAB",
         "dateTime":" 20160623101430"
    }
}

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

dateTime=20160623101430&fbPubKey=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC8IdQSg5ryvST/IC5aAjNY5sFw+qhVkyFKGqQFQCZfXa9YqsbhZFhSBZHLUw+TIJO8axH7Sa+OM4AEmoddvaPrnXRB7XJmUQMXj77AnGStzzJfQddMGMJiKa4KT6wKsmQxjC3NdKrYLVQntb9qD+M3AqIK5WBvbh/ix5GUTmUQ+QIDAQAB&rspCode=SUC0000&rspMsg=查询成功。

2.异常json报文组织:

{
	"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格式错误!


错误码

错误码描述解决方案
DCB0001DCB0001 贵方发送错误报文数太多,已被限制访问!异常操作错误太多,请根据之前的错误反馈进行更改,限制将在一定时间后自动解除
DCB0002DCB0002 请求报文数据不能为空!输入参数jsonRequestData拼写正确,并且值非空
DCB0003DCB0003 请求报文JSON格式错误!输入参数jsonRequestData为合法的JSON格式
DCB0004DCB0004 请求报文数据有误;请求报文长度过长缩短输入参数jsonRequestData内容
DCB0004DCB0004 请求报文数据有误:……错误消息有以下这些情况,请根据对应提示修改。
接口版本号version值不正确
参数编码charset值不正确
签名sign不能为空
签名算法signType值不正确
请求数据reqData不能为空
时间戳dateTime位数超长或者为0
时间戳dateTime不能为空
交易功能码txCode位数超长或者为0
交易功能码txCode不能为空
商户号merchantNo位数超长或者为0
商户号merchantNo不能为空
分行号branchNo位数超长或者为0
分行号branchNo不能为空
DCB0005DCB0005 商户未开通接入平台功能;商户号:……商户号需要开通接入平台功能
DCB0006DCB0006 源IP地址不在商户IP白名单中;商户号:…;IP地址:…商户需要提供IP添加到白名单中
DCB0007DCB0007 调用功能不可用;调用功能代码:……调用的功能不支持,请输入支持的功能代码
DCB0008DCB0008 签名验证失败:……错误消息有以下情况,请根据对应提示修改。
签名时间戳格式不正确!
签名时间错误,签名已经失效。
验签异常:……
DCB0010DCB0010商户未设置密钥;商户号:……商户未设置支付密钥,请登录商户结账处理系统设置。
DCB0019DCB0019 企业网银签名异常:……请联系招行相关技术支持人员
DCB0020DCB0020 服务器繁忙,请稍后再试。当前服务器负载达到上限,请稍后再试。
DCB0021DCB0021解析返回报文失败请联系招行相关技术支持人员