甬易支付文档中心

主题

获取对账单下载地址 ​

接口描述 ​

  • 可通过该接口获取历史对账单文件(csv格式)的下载地址。

请求URL ​

  • /bill/queryDownloadUrl

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是stringappId202409561403450909
signature是string签名
transNonce是string32请求流水号123456
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
billType是string32账单类型：
TRADE_RECEIVE-交易收款,
TRADE_REFUND-交易退款,
MERCHANT_SETTLE-商户结算,
TRADE_PS-交易分账,
MERCHANT_PAY-商户付款		TRADE_RECEIVE
billDate是string32账单日期(yyyy-MM-dd)2025-01-01
  • 注：账单日期支持最多查询半年内的订单，不支持查询当天账单

请求报文示例 ​

json
 {
  "appId": "202415629590370906",
  "billType": "TRADE_RECEIVE",
  "billDate": "2025-01-01",
  "signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg==",
  "transDate": "1731469813663",
  "transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13请求时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
billStatus是string32账单状态：
NONE-无账单数据,
SUCCESS-账单生成成功,
PROCESSING-账单生成中		SUCCESS
billDownloadUrl否string128账单下载地址，billStatus为SUCCESS时有值https://xxx.xxx.xxx/xxx.csv

响应示例 ​

json
 {
  "code": "00000000",
  "merchantNo": "XS241026000093",
  "message": "成功",
  "billStatus": "SUCCESS",
  "billDownloadUrl": "https://xxx.xxx.xxx/xxx.csv",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg=="
}

备注 ​