批量代收对账单下载地址获取
1.修订记录
| 修订 | 日期 | 说明 | 作者 |
|---|---|---|---|
| V0.1 | 2017/05/23 | 新接口参数定义 | 唐川楗 |
| V0.2 | 2017/6/23 | 去除batch_no,将out_batch_no修改不可空 | 黄月巧 |
| V0.3 | 2017/6/29 | 开放批次号长度可为1到16 | 黄月巧 |
| V0.4 | 2016/8/8 | 业务错误码优化 | 陈宋东 |
| V0.5 | 2017/10/20 | 新增异常类型ACQ.BUSINESS_TIMEOUT_ERROR（业务超时） | 陈宋东 |
| V0.6 | 2021/12/27 | 支持国密 | 王晶 |
2.接口说明
（1）场景说明
1、进行批量代收交易，需要对账单 调用接口获取对账单下载地址
（2）接口说明
1、批量代收对账单下载地址获取接口-V3.0版本
3.请求地址
| 环境 | HTTPS请求地址 |
|---|---|
| 正式环境 | https://searchds.ysepay.com/gateway.do |
4.请求参数说明
4.1公共请求参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| method | String(128) | Y | 接口名称 固定值 ysepay.ds.batch.bill.downloadurl.get |
| partner_id | String(20) | Y | 在银盛支付开设的服务商商户号，请联系客户经理提供 |
| 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 当前版本：3.0 |
| biz_content | String | Y | 业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象，下面列表描述json对象的值
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| out_batch_no | String(1,16) | Y | 商户批次号 示例值：S201703081234567 |
5.同步返回参数说明
5.1 公共响应参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| sign | String | Y | 签名字符串，Base64编码 |
| ysepay_ds_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 | 代理关系参数验证失败 | 比如代理密码解密失败，或者代理密码与委托商户号没有同时传或者同时不传 |