下载交易账单
通过接口请求指定日期的对账单,成功返回下载链接后,下载对账单压缩文件。
注意:
- 对账单只包含成功支付与成功退款订单,未支付或支付过程中关闭的订单不会包含在对账单中
- 对账单中涉及金额的字段单位为“元”
- 对账单接口只能下载三个月以内的账单
- 此接口需提前开通权限
- 对账单在每天10点后生成,建议在12点后下载
请求接口
openapi/v2/pay/download/bill
公共参数
请求参数
申请对账单,获取下载链接
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| bill_date | 是 | String(64) | 对账单日期,格式:yyyy-MM-dd,例如:2025-02-01 |
| bill_type | 否 | String(64) | 对账单类型。 ALL,返回当日所有订单信息,默认值 PAY,返回当日成功支付的订单 REFUND,返回当日退款订单 |
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| download_url | 是 | string(2048) | 对账单下载地址 |
| md5_value | 是 | String(32) | 对账单源文件MD5值 |
| expire_time | 否 | Long | 下载地址有效时间,单位秒 |
源文件下载
在响应成功后一定时间内(expire_time)内,通过download_url下载对账单压缩文件(.gz),解压后获取到账单源文件(.csv)。 对源文件做MD5,可以匹对md5_value是否一致。