接口描述:
接口版本:
版本号 |
制定人 |
制定日期 |
修订日期 |
1.0.0 |
高俭 |
2020-09-27 |
2020-09-27 |
请求URL:
请求方式:
请求头:
参数名 |
是否必须 |
类型 |
说明 |
Content-Type |
是 |
String |
请求类型:application/json |
请求参数:
参数名 |
变量名 |
类型 |
是否必须 |
说明 |
渠道号 |
agentno |
AN15 |
M |
渠道号 |
商户编号 |
merId |
AN15 |
M |
|
交易流水号 |
transFlow |
AN1..32 |
M |
必须全局唯一,建议格式:机构号+提交时间+固定位数顺序流水号。该字段值用于后续的查询交易、对账文件等的唯一标识,与批量文件名对应,能作为查询键值示例:11000002+20170321094533+000001 |
交易时间 |
transTime |
AN1..14 |
M |
格式:yyyyMMddHHmmss |
收款人账号 |
accountNo |
AN1..128 |
M |
(加密字段) |
收款人名称 |
accountName |
AN1..128 |
M |
(加密字段) |
收款账号类型 |
accountType |
AN1 |
M |
1:对公 2:对私 |
收款人开户行联行号 |
interBankNo |
AN12 |
M |
|
收款人支行名称 |
bankName |
AN1..128 |
M |
|
交易金额 |
transAmt |
AN1..16 |
M |
单位:分(代付金额) |
原消费参考号 |
oriRefNo |
AN1..12 |
M |
|
原交易日期 |
oriTransDate |
AN1..8 |
M |
格式:yyyyMMdd |
备注 |
remark |
AN1..100 |
O |
|
随机字符串 |
nonce_str |
AN1..32 |
M |
32位随机字符串 |
签名 |
sign |
AN1..32 |
M |
填写报文摘要的签名 |
签名类型 |
sign_type |
AN1..10 |
O |
签名算法类型 默认MD5 |
请求示例:
{
"nonce_str": "a6fc3711720d40a6a8645273934d701a",
"transTime": "20201023043619",
"agentno": "11000002",
"accountName": "FLg0dCa3f8L/vQuOTKIu+DTelFu3S98vbhge0NU+t7GPb6wqzipMK/FppphkkMBOtAzGJcS9jaRWzFQKteGoIPvARdcbSqqhZOvICWkDpzkeBQZ1vja1HDG31Xexp6117R1bfrqmKxZTgyRr6Z+D6VsF1TciLZgzdW8W3goBL7o\u003d",
"oriRefNo": "000000012879",
"accountType": "2",
"sign": "3923F546DCC49946A22DAF53C37651AE",
"bankName": "中国建设银行",
"oriTransDate": "20201023",
"accountNo": "GrCF+AcbWjpmGeZ5UmT6rpZloTQhGwZeTDMj6JKlFTZuzG4B0Lwbve5F0YMebpkvuLgJfjLACGybNZHGJtVsWqqSXlmAvoUYAI8lDcc28SYzLCo9IGfHr4wbKQnI787/YV7iquPQGHzSdibAO/qjsptWNV453Utj5ijAO1hmVF8\u003d",
"transAmt": "10000",
"transFlow": "1374274",
"merId": "XRT000027808042",
"interBankNo": "105100000017"
}
返回示例:
正确时返回:
{
"code": "0000",
"data": {
"agentno": "11000002",
"nonce_str": "a6fc3711720d40a6a8645273934d701a",
"retCode": "0000",
"retMsg": "交易成功",
"settleDate": "20201023",
"sign": "C558749D58FDDEF0C7ADA888F80A71A4",
"transFlow": "1374274",
"transTime": "20201023043619"
},
"msg": "处理成功"
}
错误时返回:
返回参数说明:
参数名 |
变量名 |
类型 |
是否必须 |
说明 |
返回码 |
code |
AN4 |
M |
0000 为成功, 其他为失败 |
返回信息 |
msg |
ANS1…50 |
M |
返回信息描述 |
渠道号 |
agentno |
AN15 |
M |
渠道号 |
交易流水号 |
transFlow |
AN1..32 |
M |
同请求 |
交易时间 |
transTime |
AN1..14 |
M |
同请求 |
清算日期 |
settleDate |
AN8 |
M |
格式:yyyyMMdd |
随机字符串 |
nonce_str |
AN1..32 |
M |
32位随机字符串 |
签名 |
sign |
AN1..32 |
M |
填写报文摘要的签名 |
备注:
文档更新时间: 2020-10-23 18:47 作者:高俭