1.1. 背景
背景:现已有小工具对接支付宝账单,但考虑到稳定性前提需要通过接口下载测试验证是否可用。
1.2. 验收目标
1.支付宝查询对账单接口下载,并解释到数据库
2. 功能设计
2.2.1 操作路径
1. 无
2.2.3
2.2.3.1 功能点描述:
原设计:
无
新增:
https://opendocs.alipay.com/open/02irgt
因为响应接口是一窜链接,只能通过开发者账号测验才知道内容是否匹配财务需求可用。
如果可用情况将替代现有小工具账单下载
请求参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| bill_type | String | 必选 | 20 | 账单类型,商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型,支持: trade:商户基于支付宝交易收单的业务账单; signcustomer:基于商户支付宝余额收入及支出等资金变动的账务账单; trade_zft_merchant:直付通二级商户查询交易的业务账单; zft_acc:直付通平台商查询二级商户流水使用,返回所有二级商户流水。 |
trade |
| bill_date | String | 必选 | 15 | 账单时间: * 日账单格式为yyyy-MM-dd,最早可下载2016年1月1日开始的日账单。不支持下载当日账单,只能下载前一日24点前的账单数据(T+1),当日数据一般于次日 9 点前生成,特殊情况可能延迟。 * 月账单格式为yyyy-MM,最早可下载2016年1月开始的月账单。不支持下载当月账单,只能下载上一月账单数据,当月账单一般在次月 3 日生成,特殊情况可能延迟。 |
2016-04-05 |
| smid | String | 可选 | 20 | 二级商户smid,这个参数只在bill_type是trade_zft_merchant时才能使用 | 2088123412341234 |
响应参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| bill_download_url | String | 必选 | 2048 | 账单下载地址链接,获取连接后30秒后未下载,链接地址失效。 | http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&userId=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X |