开发文档

交易账单

应用场景：

商户可以通过该接口下载历史交易清单。

注意：

1、在QQ钱包侧未成功下单的交易不会出现在对账单中；

2、QQ钱包在次日9点启动生成前一天的对账单，建议商户10点后再获取；

3、对账单中涉及金额的字段单位为“元”；

4、对账单接口只能下载三个月以内的对账单。

接口地址：

https://qpay.qq.com/cgi-bin/sp_download/qpay_mch_statement_down.cgi

是否需要证书：

否

接口规则

· 为保证交易安全性，采用HTTPS传输

· 采用POST方法提交

· 统一采用UTF-8字符编码

 更多详情见接口规则

请求参数：

示例如下：

  <xml>

     <appid>2421b1c4370ec43b</appid>

     <bill_date>20160306</bill_date>

     <bill_type>ALL</bill_type>

     <mch_id>10000100</mch_id>

     <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>

     <sign>332F17B766FC787203EBE9D6E40457A1</sign>

 </xml>

返回结果：

成功时，输出为文本。

第一行为表头，根据请求下载的对账单类型不同而不同(由bill_type决定), 目前有：

当日所有交易账单

交易时间、商户号、商户APPID、子商户号、子商户APPID、用户标识、设备号、支付方式、商户订单号、QQ钱包订单号、付款银行、货币种类、订单金额、商户优惠金额、商户应收金额、QQ钱包优惠金额、用户支付金额、交易状态、退款提交时间、商户退款订单号、QQ钱包退款订单号、退款金额、退还QQ钱包优惠金额、退款状态、退款成功时间、退款方式、商品名称、商户数据包、手续费金额、费率

当日支付账单

交易时间、商户号、商户APPID、子商户号、子商户APPID、用户标识、设备号、支付方式、商户订单号、QQ钱包订单号、付款银行、货币种类、订单金额、商户优惠金额、商户应收金额、QQ钱包优惠金额、用户支付金额、交易状态、商品名称、商户数据包、手续费金额、费率

当日退款账单

交易时间、商户号、商户APPID、子商户号、子商户APPID、用户标识、设备号、支付方式、商户订单号、QQ钱包订单号、付款银行、货币种类、订单金额、商户优惠金额、商户应收金额、QQ钱包优惠金额、用户支付金额、交易状态、退款提交时间、商户退款订单号、QQ钱包退款订单号、退款金额、退还QQ钱包优惠金额、退款状态、退款成功时间、退款方式、商品名称、商户数据包、手续费金额、费率

当日现金账户退款账单

交易时间、商户号、商户APPID、子商户号、子商户APPID、用户标识、设备号、支付场景、商户订单号、QQ钱包订单号、付款银行、货币种类、订单金额、商户优惠金额、商户应收金额、QQ钱包优惠金额、用户支付金额、交易状态、退款提交时间、商户退款订单号、QQ钱包退款订单号、退款金额、退还QQ钱包优惠金额、退款状态、退款成功时间、退款方式、商品名称、商户数据包、退还手续费金额、费率

从第二行开始，为交易流水，各参数以逗号分隔，参数前增加`符号，为标准键盘1左边键的字符，字段顺序与表头一致。

倒数第二行为汇总字段，

当日所有交易账单汇总字段包括交易总笔数、订单总金额、商户优惠总金额、商户应收总金额、QQ钱包优惠总金额、用户支付总金额、退款总金额、退还QQ钱包优惠总金额、手续费总金额；

当日支付账单汇总字段包括交易总笔数、订单总金额、商户优惠总金额、商户应收总金额、QQ钱包优惠总金额、用户支付总金额、手续费总金额；

当日退款账单汇总字段包括交易总笔数、订单总金额、商户优惠总金额、商户应收总金额、QQ钱包优惠总金额、用户支付总金额、退款总金额、退还QQ钱包优惠总金额、手续费总金额；

当日现金账户退款汇总字段包括交易总笔数、订单总金额、商户优惠总金额、商户应收总金额、QQ钱包优惠总金额、用户支付总金额、退款总金额、退还QQ钱包优惠总金额、退还手续费总金额。

最后一行为汇总字段对应数据。

示例：

交易时间,商户号,商户APPID,子商户号,子商户APPID,用户标识,设备号,支付场景,商户订单号,QQ钱包订单号,付款银行,货币种类,订单金额(元),商户优惠金额(元),商户应收金额(元),QQ钱包优惠金额(元),用户支付金额(元),交易状态,退款提交时间,商户退款订单号,QQ钱包退款订单号,退款金额(元),退还QQ钱包优惠金额(元),退款状态,退款成功时间,退款方式,商品名称,商户数据包,手续费金额(元),费率

2016/7/23 14:14,1263732001,暂无数据,1263711801,暂无数据,暂无数据,暂无数据,暂无数据,`100540000011201607231001010451,`1263711801461607231903720235,财付通余额,RMB,0,暂无数据,暂无数据,0,,转入退款,2016/7/2314:14,`REV_100540000011201607231001010451,`1121263711801607230535066910,0.01,0,退款成功,暂无数据,暂无数据,暂无数据,暂无数据,暂无数据,暂无数据

交易总笔数,订单总金额(元),商户优惠总金额(元),商户应收总金额(元),QQ钱包优惠总金额(元),用户支付总金额(元),退款总金额(元),退还QQ钱包优惠总金额(元),手续费总金额(元)

9,0,0,0,0,0,353.04,0,0

注意：

1、 直连商户的“子商户号”、“子商户APPID”值为空

2、 “商户APPID、子商户APPID，用户标示、设备号、支付场景、商户优惠金额、商户应收金额、用户支付金额、退款提交时间、退款成功时间、退款方式、商户数据包、手续费金额、费率”  暂时为空，后续会陆续补上

3、 没有优惠活动时，优惠相关字段值为空

错误码：