开发文档

资金账单

应用场景:

商户可以通过该接口下载自2018年9月1日起的历史资金流水账单。

注意:

1、资金账单中的数据反映的是QQ钱包商户账户资金变动情况;

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

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

接口地址:

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

是否需要证书:

接口规则:

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

· 采用POST方法提交

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

 更多详情见接口规则

 

请求参数:

变量名

字段名

字段类型

必填

描述

示例

mch_id

商户号

String(10)

QQ钱包分配的商户号

1900000109

nonce_str

随机字符串

String(32)

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

3e5a036cb4bc3a677a38ad9d69eb3feb

sign

签名

String(32)

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

c380bec2bfd727a4b6845133519f3ad6

bill_date

账单时间

String(8)

交易实际发生的日期

格式为YYYYMMDD

20190101

acc_type

账单类型

String(32)

取值及含义如下:

CASH:现金账户

MARKETING:营销账户

 

MARKETING

示例如下:

<xml>

<acc_type>MARKETING</acc_type>

<bill_date>20190101</bill_date>

<mch_id>1900000109</mch_id>

<nonce_str>3e5a036cb4bc3a677a38ad9d69eb3feb </nonce_str>

<sign>c380bec2bfd727a4b6845133519f3ad6</sign>

</xml>

返回结果

接口请求成功时,数据以文本表格的方式返回

1)第一行为表头

交易时间,账户类型,业务类型,资金流水订单号,业务订单号,商户订单号,收支类型,收支金额(),账户结余(),备注

2从第二行起,为资金流水数据,各参数以逗号分隔,参数前增加`符号,为标准键盘1左边键的字符,字段顺序与表头一致

3)倒数第二行为资金账单统计标题

资金流水总笔数,收入笔数,收入金额(),支出笔数,支出金额(元)

4最后一行为统计数据

账单示例如下:

交易时间,账户类型,业务类型,资金流水订单号,业务订单号,商户订单号,收支类型,收支金额(元),账户结余(元),备注

` 2019-07-09 15:03:10,`营销账户,`转账,` 100010290119070910095342923312650000,`,` __100010290112201907091564720000,`支出,`-8.88,` 888.00,`测试

接口请求时如有协议错误,将返回以下字段

变量名

字段名

字段类型

必填

描述

 示例

retcode

返回错误码

String(16)

原始错误码

66230532

retmsg

返回错误信息

String(128)

返回信息,如非空,为错误原因:签名失败;

文件未找到;

file not exist

请求协议错误示例:

<xml>

<retcode>66230533</retcode>

<retmsg>file not exist</retmsg>

</xml>

错误码:

错误码

描述

原因

解决办法

66227021

系统错误

系统错误

请尝试再次查询

66201001

参数错误

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

请求参数错误,重新检查

66209002

账单时间格式错误

bill_date参数格式错误

按文档指引的账单时间格式(YYYYMMDD)再次查询

66230532

签名错误

签名错误

按文档生成正确签名信息再次查询

66230533

账单文件不存在

账单文件不存在

账户流水信息为空