跳到主要内容

下载交易账单

通过接口请求指定日期的对账单,成功返回下载链接后,下载对账单压缩文件。

注意:
  • 对账单只包含成功支付与成功退款订单,未支付或支付过程中关闭的订单不会包含在对账单中
  • 对账单中涉及金额的字段单位为“元”
  • 对账单接口只能下载三个月以内的账单
  • 此接口需提前开通权限
  • 对账单在每天10点后生成,建议在12点后下载

请求接口

openapi/v2/pay/download/bill

公共参数

接口协议 - 公共参数

请求参数

申请对账单,获取下载链接

参数必填类型说明
bill_dateString(64)对账单日期,格式:yyyy-MM-dd,例如:2025-02-01
bill_typeString(64)对账单类型。
ALL,返回当日所有订单信息,默认值
PAY,返回当日成功支付的订单
REFUND,返回当日退款订单

响应参数

名称必填类型说明
download_urlstring(2048)对账单下载地址
md5_valueString(32)对账单源文件MD5值
expire_timeLong下载地址有效时间,单位秒

源文件下载

在响应成功后一定时间内(expire_time)内,通过download_url下载对账单压缩文件(.gz),解压后获取到账单源文件(.csv)。 对源文件做MD5,可以匹对md5_value是否一致。