对账单下载
| 应用场景
本接口用于下载企业付款的对账单。对账单中只有付款成功的记录,企业付款失败的订单不体现在对账单中;
企业付款成功、但转账给收款用户失败的订单,资金会在付款成功后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 非法 | 请检查APPID和OPENID |
TOTAL_FEE_OUT_OF_LIMIT | 单笔限额检查失败 | 单笔限额不符合限制要求 | 请确认该笔支付订单的金额是否在限制区间内 |
SPID_NOT_ALLOW | 当前商户不支持企业付款 | 商户号没有企业付款权限 | 请确认该商户号的权限 |
REALNAME_CHECK_ERROR | 实名检查失败 | 用户未实名 | 用户未实名无法收款,商户可引导用户进行实名 |
RE_USER_NAME_CHECK_ERROR | re_user_name检查失败 | 用户真实姓名校验失败 | 请重新确认用户的真实姓名 |