@ulodev
2019-11-25T03:39:30.000000Z
字数 1451
阅读 916
退汇信息查询接口(内部接口)
1.1. 接口地址
测试： http://api.agent.test.szulodev.com/secapi/pay/spi
生产： 找商务获取
1.2. 输入参数
| 字段名 |
变量名 |
类型 |
必填 |
描述 |
| 平台编码 |
appid |
String(32) |
是 |
接口请求来源平台编码 例如:bank_cloud |
| 接口代码 |
apicode |
String(32) |
是 |
AP14 |
| 交易日期 |
trade_date |
String(32) |
是 |
交易日期,格式yyyy-MM-dd |
| 页码 |
page_num |
String(11) |
是 |
默认1页为50条数据
|
| 随机字符串 |
nonce_str |
String(32) |
是 |
随机字符串，不长于 32 位 |
| 签名 |
sign |
String(32) |
是 |
签名，详见签名生成算法 |
1.3. 返回结果
| 字段名 |
变量名 |
类型 |
必填 |
描述 |
| 返回状态码 |
return_code |
String(16) |
是 |
SUCCESS/FAIL
此字段是通信标识，非交易标识，交易是否成功需要查看
result_code 来判断 |
| 返回信息 |
return_msg |
String(128) |
否 |
返回信息，如非空，为错误原因 签名失败
参数格式校验错误 |
|
当 return_code 为 SUCCESS 的时候，还会包括以下字段：
|
| 签名 |
sign |
String(32) |
是 |
返回的签名，详见签名生成算法 |
| 业务结果 |
result_code |
String(16) |
是 |
SUCCESS/FAIL |
| 错误代码 |
err_code |
String(32) |
否 |
详细参见错误列表 |
| 错误代码描述 |
err_code_des |
String(128) |
否 |
错误返回的信息描述 |
|
当 return_code 和 result_code 都为 SUCCESS的时，还会包括以下字段（&n表示从0开始开始编号）：
|
| 条数 |
total_rows |
String(32) |
是 |
退汇记录条数 |
| 页码 |
total_page |
String(32) |
否 |
退汇记录页码 |
| 起始记录号 |
begin_num |
String(32) |
否 |
|
| 结束记录号 |
end_num |
String(32) |
否 |
对账编号 |
| 退汇查询记录 |
reexchange_record_&n |
String(32) |
否 |
json格式 |
|
reexchange_record 包括以下字段：
|
| 退汇单号 |
trans_no |
String(32) |
是 |
即代付交易平台单号 |
| 商户单号 |
out_trade_no |
String(32) |
是 |
商户交易单号 |
| 退汇原因说明 |
body |
String(32) |
是 |
退汇详情 |
1.4. 错误码
| 名称 |
描述 |
原因 |
解决方案 |
| NOAUTH |
商户无此接口权限 |
商户未开通此接口权限 |
请商户前往申请此接口权限 |
| SYSTEMERROR |
系统错误 |
系统超时 |
系统异常，请用相同参数重新调用 |
| REPAYMENT_PARAMS_ERROR |
还款信息查询参数错误 |
缺少必传参数 |
检查必传参数是否传入 |
| REPAYMENT_NOT_EXIST |
还款信息不存在 |
根据当前条件查询不到还款信息 |
确认当前传入参数是否正确 |
| MCHID_NOT_EXIST |
MCHID 不存在 |
参数中缺少 MCHID |
请检查 MCHID 是否正确 |
| LACK_PARAMS |
缺少参数 |
缺少必要的请求参数 |
请检查参数是否齐全 |
| SIGNERROR |
签名错误 |
参数签名结果不正确 |
请检查签名参数和方法是否都符合签名算 法要求 |
| XML_FORMAT_ERROR |
XML 格式错误 |
XML 格式错误 |
请检查 XML 参数格式是否正确 |
| REQUIRE_POST_METHOD |
请使用 post 方法 |
未使用 post 传递参数 |
请检查请求参数是否通过 post 方法提交 |
| POST_DATA_EMPTY |
post 数据为空 |
post 数据不能为空 |
请检查 post 数据是否为空 |
| NOT_UTF8 |
编码格式错误 |
未使用指定编码格式 |
请使用 NOT_UTF8 编码格式 |
