开发文档

对账单下载

| 应用场景
商户可以通过本接口,下载现金红包的历史清单。

| 接口地址

https://api.qpay.qq.com/cgi-bin/hongbao/qpay_hb_mch_down_list_file.cgi


| 接口规则

  • 请求格式:HTTP表单(POST)or QueryString(GET)
  • 响应格式:默认JSON,如接口明确指出,则参考接口描述


| 输入参数

参数名

字段名

字段类型

必填

描述

sign

商户签名

string(32)

M

商户签名

mch_id

商户号

string(10)

M

商户号

date

账单日

Int

M






示例:https://api.qpay.qq.com/cgi-bin/hongbao/qpay_hb_mch_down_list_file.cgi?mch_id=1200000501&date=20160824&sign=12345678901234567890123456789001


| 输出

正常时,输出为对账文件;异常时,按照默认,响应JSON串。

1、文件名称和格式

mqq_$(mch_id)_$(date)_$(recnum)_list.csv

  • (mch_id): 商户号
  • (date): 账单日
  • (recnum): 记录数

示例: mqq_2000000501_20160826_1003454_list.csv 

2、文件内容和格式

内容:红包单号,金额,红包状态,创建时间

格式:`send_list,`total_amount,`state,`create_time", '`,'分割字段,'\\n'进行换行

示例: `12345602561605151234560256111111,`150,`2,`2016-08-26 18:33:00

state字段:1,未抢完;2,抢完;3,过期;4,退款;