资金账单
应用场景:
商户可以通过该接口下载自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-0915:03:10,`营销账户,`转账,` 100010290119070910095342923312650000,`,` __100010290112201907091564720000,`支出,`-8.88,` 888.00,`测试
接口请求时如有协议错误,将返回以下字段
变量名 | 字段名 | 字段类型 | 必填 | 描述 | 示例 |
retcode | 返回错误码 | String(16) | 是 | 原始错误码 | 66230532 |
retmsg | 返回错误信息 | String(128) | 否 | 返回信息,如非空,为错误原因:签名失败; 文件未找到; | file not exist |
请求协议错误示例:
<xml>
<retcode>66230533</retcode>
<retmsg>filenot exist</retmsg>
</xml>
错误码:
错误码 | 描述 | 原因 | 解决办法 |
66227021 | 系统错误 | 系统错误 | 请尝试再次查询 |
66201001 | 参数错误 | 请求参数未按指引进行填写 | 请求参数错误,重新检查 |
66209002 | 账单时间格式错误 | bill_date参数格式错误 | 请按文档指引的账单时间格式(YYYYMMDD)再次查询 |
66230532 | 签名错误 | 签名错误 | 请按文档生成正确签名信息再次查询 |
66230533 | 账单文件不存在 | 账单文件不存在 | 账户流水信息为空 |