请求地址
生产环境
https://payment.ebank.cmbchina.com/NetPayment/BaseHttp.dll?QuerySettledRefund
测试环境
http://121.15.180.66:801/netpayment_dl/BaseHttp.dll?QuerySettledRefund
请求报文
报文的参数名: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
|
20160623120100 |
分行号 |
branchNo |
String(4) |
M |
商户分行号,4位数字 |
0755 |
商户号 |
merchantNo |
String(6) |
M |
商户号,6位数字 |
000054 |
查询类型 |
type |
String(1) |
M |
查询类型
A:按银行退款流水号查单笔
B:按商户订单号+商户退款流水号查单笔
C: 按商户订单号查退款
|
A |
订单号 |
orderNo |
String(32) |
C |
商户订单号 |
9999000001 |
订单日期 |
date |
String(8) |
M |
商户订单日期,格式:yyyyMMdd |
20160624 |
商户退款流水号 |
merchantSerialNo |
String(20) |
C |
商户退款流水号长度不超过20位
1.商户送商户退款流水号查单笔;
2.商户不送商户退款流水号,查退款订单;
|
20161101180000010001 |
银行退款流水号 |
bankSerialNo |
String(20) |
C |
银行退款流水号长度不超过20位 |
20161101180000010001 |
请求示例
1.json报文组织:
{
"version":"1.0",
"sign":"DFAC9FF11DB20CFB75DD219694E8EAFA5C38D5658B0DC4CBAF39759FAF6A56C8",
"signType":"SHA-256",
"charset":"UTF-8",
"reqData":{
"dateTime":"20161227161057",
"branchNo":"0755",
"merchantNo":"000054",
"date":"20161105",
"orderNo":"1336480523",
"type":"C",
"merchantSerialNo":"",
"bankSerialNo":""
}
}
2.表单组织:
<form action="请求地址" method="post" >
<input type="hidden" name="jsonRequestData" value='以上json字符串' />
<input type="hidden" name="charset" value='utf-8' />
</form>
3.待签名字符串示例(未包含支付密钥):
bankSerialNo=&branchNo=0755&date=20161105&dateTime=20161227161057&merchantNo=000054&merchantSerialNo=&orderNo=1336480523&type=C
响应示例
1.正常json报文组织:
{
"version":"1.0",
"charset":"utf-8",
"rspData":{
"rspCode":"SUC0000",
"rspMsg":"",
"dateTime":"20161227161149",
"dataCount":"1",
"dataList":"branchNo,`merchantNo,`date,`orderNo,`bankSerialNo,`merchantSerialNo,`orderStatus,`currency,`amount,`fee,`acceptDate,`acceptTime,`bankDate,`bankTime,`desc\r\n0755,`000054,`20161105,`1336480523,`16322749300000000020,`123456789,`210,`10,`0.01,`0.00,`20161227,`160330,`20161227,`160330,`aaa"
}
}
2.异常jason报文组织
{
"version":"1.0",
"charset":"UTF-8",
"rspData":{
"rspCode":"MSS3207",
"rspMsg":"MSS3207.无效银行退款流水号"
}
}