下载账单
更新时间:2024.12.27下载账单API为通用接口,交易/资金账单都可以通过该接口获取到对应的账单。
注意
- 账单文件的下载地址的有效时间为30s。
- 强烈建议商户将实际账单文件的哈希值和之前从接口获取到的哈希值进行比对,以确认数据的完整性。
# 接口说明
支持商户: 【普通服务商】
请求方式: 【GET】
请求URL: 通过申请账单接口获取到"download_url",URL有效期30s
前置条件: 调用申请账单接口并获取到"download_url"
# 请求参数
# 返回参数
# 文件格式说明
账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据。 明细数据每一行对应所下载账单的一条具体数据,同时明细数据中每一个字段前都加入了`字符(重音符,为标准键盘1左边键的字符),以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。 不同类型的账单文件的明细数据和汇总数据的格式是不同的,具体示例如下:
# 交易账单
《ALL.xlsx》 (opens new window)、《REFUND.xlsx》 (opens new window)、《SUCCESS.xlsx》 (opens new window)
# 资金流水账单
《资金账单.xlsx》 (opens new window)
# 错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 参数错误 | 请按第一步申请账单的API指引,重新获取账单地址后再请求 |
403 | NO_AUTH | 权限异常 | 请检查本次请求的商户是否与第一步申请账单API的请求商户一致 |
文档是否有帮助