批量代付对账单下载地址获取
1.修订记录
| 修订 | 日期 | 说明 | 作者 |
|---|---|---|---|
| V0.1 | 2017/03/08 | 新接口参数定义 | 陈宋东 |
| V0.2 | 2017/4/17 | 修改域名为searchdf.ysepay.com | 陈宋东 |
| V0.3 | 2017/6/23 | 将batch_no去掉，out_batch_no修改为不可空 | 黄月巧 |
| V0.4 | 2017/6/29 | 开放查询类批次号长度可为1到16 | 黄月巧 |
| V0.5 | 2016/8/8 | 业务错误码优化 | 陈宋东 |
| V0.6 | 2017/9/18 | 公共参数新加proxy_password和merchant_usercode参数 | 黄月巧 |
| V0.7 | 2017/10/20 | 新增异常类型ACQ.BUSINESS_TIMEOUT_ERROR（业务超时） | 陈宋东 |
| V0.8 | 2020/11/30 | 修改关于ACQ.SYSTEM_ERROR的中文描述 | 汤吉齐 |
| V0.9 | 2021/12/27 | 支持国密 | 王晶 |
2.接口说明
（1）场景说明
1、批量代付对账单时获取下载地址
（2）接口说明
1、 批量代付对账单下载地址获取
3.请求地址
| 环境 | HTTPS请求地址 |
|---|---|
| 正式环境 | https://searchdf.ysepay.com/gateway.do |
4.请求参数说明
4.1公共请求参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| method | String(128) | Y | 接口名称。固定值：ysepay.df.batch.bill.downloadurl.get |
| partner_id | String(20) | Y | 商户在银盛支付平台开设的用户号[商户号] |
| proxy_password | String(50) | N | 代理密码，加密传输 |
| merchant_usercode | String(20) | N | 真实商户用户号，示例值：pinganyinhang02 |
| timestamp | String(19) | Y | 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"，示例值：2014-07-24 03:07:50 |
| charset | String(10) | Y | 商户网站使用的编码格式，如utf-8、gbk、gb2312等。示例值：GBK |
| sign_type | String(10) | Y | 签名类型，RSA/SM |
| sign | String(256) | Y | 签名字符串，再用Base64编码 |
| version | String(3) | Y | 接口版本，示例值：3.0 |
| biz_content | String | Y | 业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象，下面列表描述json对象的值
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| out_batch_no | String(1,16) | Y | 商户批次号，注：银盛批次流水号为空时，必填，示例值：F201703081234567 |
5.同步返回参数说明
银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。
请注意:银盛后期对返回参数保留扩展的权利，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1 公共响应参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| sign | String | Y | 签名字符串，Base64编码 |
| ysepay_df_batch_bill_downloadurl_get_respose | String | Y | 业务响应参数的集合，最大长度不限 |
5.2 业务响应参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| code | String | Y | 响应代码 |
| msg | String | Y | 响应代码描述 |
| batch_bill_download_url | String(2048) | Y | 账单下载地址链接，获取连接后30秒后未下载，链接地址失效。示例值：https://downloaddsf.ysepay.com/download/batch/201704110941250C0DhW361O/B2021404240042021523 |
6.样例
无
7.附录
7.1 业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| ACQ.SYSTEM_ERROR | 系统错误 | 支付中该状态为未知状态，请勿当成失败状态处理，请等待支付通知或继续查询 |
| ACQ.BUSINESS_TIMEOUT_ERROR | 业务超时 | 请调用查询接口查询订单状态 |
| ACQ.INVALID_PARAMETER | 参数校验错误 | 请检查请求参数，修改后重新发起请求 |
| ACQ.BATCH_INFO_NOT_EXIST | 批次信息不存在 | 请核查商户批次号或者银盛批次流水号,如还有问题，请联系银盛 |
| ACQ.BATCH_DSF_TRANSACTION_TYPE_ERROR | 批量代收付交易类型错误 | 请核查确认交易类型是否正确 |
| ACQ.BATCH_NOT_COMPLETE_PROCESSING | 该批次尚未处理完成 | 请耐心等待，该批次尚未处理完成 |
| ACQ.SYSTEM_BUSY | 系统繁忙 | 请稍后再试，如还有问题，请联系银盛 |
| ACQ.TOKEN_IS_NOT_EXIST | 该标识对应的对账文件不存在 | 请核查标识是否最新，如还有问题，请联系银盛 |
| ACQ.BILL_FILE_NOT_GENERATE | 对账文件尚未生成 | 请耐心等待，该对账文件尚未生成，稍后重新发起请求 |
| ACQ.BATCH_NOT_TRADE_ON_THE_DAY | 该批次当天无交易 | 核查确认该批次当天有无交易 |
| ACQ.BILL_FILE_GENERATE_FAIL | 该对账文件生成失败 | 请稍后再试，如还有问题，请联系银盛 |
| ACQ.DOWNLOAD_BILL_FILE_TIMEOUT | 下载超时 | 请重新发起，标识已过期（过期时间：30s） |
| ACQ.SYSTEM_BUSY | 系统繁忙 | 请稍后再试，如还有问题，请联系银盛 |
| ACQ.BILL_FILE_EXPIRE | 该对账文件过期,已清除 | |
| ACQ.PROXY_CHECK_FAILD | 代理关系检查失败 | 比如委托关系不存在 |
| ACQ.PROXY_CHECK_PARAM | 代理关系参数验证失败 | 比如代理密码解密失败，或者代理密码与委托商户号没有同时传或者同时不传 |