开发文档

交易账单

应用场景:

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

注意:

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字符编码

 更多详情见接口规则


请求参数:

变量名

字段名

字段类型

必填

描述

示例

appid

应用ID

String(32)

腾讯开放平台或QQ互联平台审核通过的应用APPID

1007033799

mch_id

商户号

String(32)

QQ钱包分配的商户号

1900000109

nonce_str

随机字符串

String(32)

随机字符串,不长于32位,推荐随机数生成算法

3e5a036cb4bc3a677a38ad9d69eb3feb

sign

签名

String(128)

商户签名,详见商户签名算法规则

C380BEC2BFD727A4B6845133519F3AD6

bill_date

对账单时间

String(32)

交易实际发生的日期

格式为YYYYMMDD

20160306

bill_type

对账单类型

String(32)

ALL,返回当日所有交易账单

SUCCESS,返回当日支付账单

REFUND,返回当日退款账单

RECHAR,返回当日现金账户退款账单

ALL

tar_type

压缩账单

String(8)

非必传,如果传入则返回格式为.gzip的压缩包账单,不传则默认为数据流形式

GZIP

示例如下:

<xml>

     <appid>2421b1c4370ec43b</appid>

     <bill_date>20141110</bill_date>

     <bill_type>ALL</bill_type>

     <mch_id>10000100</mch_id>

     <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>

     <sign>332F17B766FC787203EBE9D6E40457A1</sign>

</xml>


返回结果:

变量名

字段名

字段类型

必填

描述

示例

retcode

返回状态码

String(16)

原始错误码

66230532

retmsg

返回信息

String(128)

返回信息,如非空,为错误原因:签名失败、参数格式校验错误、该日期订单未生成

ERR_SP_SIGN

 成功时,输出为文本:

第一行为表头,根据请求下载的对账单类型不同而不同(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


注意:

“用户标识、设备号、支付场景、商户优惠金额、商户应收金额、用户支付金额、商户数据包、手续费金额、费率”  暂时为空,后续会陆续完善。


错误码:

错误码

描述

原因

解决办法

SYSTEMERROR

系统错误

系统错误

请尝试再次查询

INVALID_TRANSACTIONID

无效transaction_id

请求参数未按指引进行填写

请求参数错误,重新检查

PARAM_ERROR

参数错误

请求参数未按指引进行填写

请求参数错误,重新检查

ERR_SP_SIGN

签名错误

求参数签名错误

检查签名生成逻辑