开发文档

对账单下载

| 应用场景

本接口用于下载企业付款的对账单。对账单中只有付款成功的记录,企业付款失败的订单不体现在对账单中;

企业付款成功、但转账给收款用户失败的订单,资金会在付款成功后24小时自动退还到商户的营销账户。


| 接口说明

请求地址:https://qpay.qq.com/cgi-bin/pay/qpay_epay_statement_down.cgi

请求方式:POST

是否需要证书:不需要


| 请求参数

变量名

字段名

字段类型

必填

描述

示例

mch_id

商户号

String(32)

商户号

1900005631

nonce_str

随机字符串

String(32)

随机字符串,不长于32位,详见随机数算法

3e5a036cb4bc3a677a38ad9d69eb3feb

bill_date

对账单时间

String(32)

对账单时间,格式为YYYYMMDD

20091225

sign

商户签名

String(128)

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

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

示例如下:

<?xml version="1.0" encoding="UTF-8" ?>

<xml>

<mch_id>1900005631</mch_id>

<nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str>

<bill_date>20170506</bill_date>

<sign>332F17B766FC787203EBE9D6E40457A1</sign>

</xml>


| 输出参数

失败时,返回:

变量名

字段名

字段类型

必填

描述

示例

return_code

返回码

String(16)

SUCCESS/FAIL

此字段是通信标识,非交易标识

SUCCESS

return_msg

返回信息

String(128)

返回信息,如非空,为错误原因 

系统繁忙

retcode

原始错误码

String(16)

原始错误码

10025

retmsg

原始错误原因

String(128)

原始错误原因

繁忙

result_code

业务结果

String(16)

FAIL

FAIL

err_code

错误码

String(32)

错误码

SYSTEMERROR

err_code_desc

错误描述

String(128)

错误描述

系统错误

nonce_str

随机字符串

String(32)

随机字符串

3e5a036cb4bc3a677a38ad9d69eb3feb

成功时,输出为文本,如下:

第一行为表头:交易时间、商户号(付款)、商户APPID、收款用户、转账类型、商户订单号、QQ钱包订单号、货币种类、付款金额、转账状态、转账备注、手续费金额、费率
中间行为明细数据;

倒数第二行为汇总数据:交易总笔数,订单总金额(元),手续费总金额(元)
最后一行为明细MD5


| 错误代码

错误码

描述

原因

解决方案

SYSTEMERROR

系统错误

系统错误

重入调用接口

PARAM_ERROR

参数错误

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

检查参数

SIGNERROR

商户签名错误

参数签名结果不正确

请检查签名参数和方法是否都符合签名算法要求,比如检查签名顺序和key正确性

OP_USER_PASSWD_ERROR

操作员密码错误

操作员密码校验失败

尝试用密码登录qpay.qq.com确认操作员密码是否正确

OP_USER_AUTH_ERROR

操作员权限错误

该操作员ID不具备企业付款权限

登录qpay.qq.com修改权限,确认该操作员ID具有企业付款权限

TRANSFER_FEE_LIMIT_ERROR

转账限额错误

针对此用户的转账金额上、下限、单日转账次数超出了限制

检查此用户的转账额度、转账次数是否超出了限制

TRANSFER_FAIL

转账失败

收款用户的账户不支持收款,收款失败

确认收款用户的账户是否正常

NOTENOUTH

商户营销账户余额不足

商户营销账户的余额不足

登录qpay.qq.com,给营销账户充值

ORDERNOTEXIST

转账订单不存在

订单不存在

请检查订单号是否正确

APPID_OR_OPENID_ERR

appid  openid 非法

appid  openid 非法

请检查APPIDOPENID

TOTAL_FEE_OUT_OF_LIMIT

单笔限额检查失败

单笔限额不符合限制要求

请确认该笔支付订单的金额是否在限制区间内

SPID_NOT_ALLOW

当前商户不支持企业付款

商户号没有企业付款权限

请确认该商户号的权限

REALNAME_CHECK_ERROR

实名检查失败

用户未实名

用户未实名无法收款,商户可引导用户进行实名

RE_USER_NAME_CHECK_ERROR

re_user_name检查失败

用户真实姓名校验失败

请重新确认用户的真实姓名