开发指引

1、整体业务开发流程概览

服务商如有对账需求，可在上午十点后可调用申请账单接口（交易账单或资金账单），获取前三个月内任一天的账单下载链接（download_url），并通过该链接下载获取账单文件。

服务商也可登录服务商平台，在【交易中心 -> 账单管理】手动下载账单，参考：平台下载账单操作指引。

2、详细步骤说明

2.1、申请账单下载链接

商户调用申请账单API（申请交易账单/申请资金账单）获取账单文件下载链接download_url(5分钟内有效)。

申请账单关键参数说明：

bill_date：账单日期，格式yyyy-MM-DD，需要是3个月以内的，不能为请求接口当天的日期

tar_type(非必填)：传固定值“GZIP”则在通过下载链接下载文件时，返回的是压缩文件流，不填则默认是返回账单文件的字符串流

2.2、下载账单文件

服务商获得5分钟有效期的下载链接（download_url）后，需通过GET方式请求并按apiv3标准生成签名来获取账单文件，不得直接在浏览器中访问。默认返回账单文件内容，服务商需用utf-8编码读取；若申请账单时tar_type指定了GZIP压缩类型，则返回.gzip格式压缩文件，需先解压再读取账单内容。账单文件下载后服务商应计算哈希值，并与申请账单返回的哈希值对比，以确保账单完整性。