最新更新时间：2024.01.30 版本说明
商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。
● 微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致；
● 微信在次日9点启动生成前一天的对账单，建议商户10点后再获取；
● 对账单中涉及金额的字段单位为“元”。
● 对账单接口只能下载三个月以内的账单。
● 对账单是以商户号纬度来生成的，如一个商户号与多个appid有绑定关系，则使用其中任何一个appid都可以请求下载对账单。对账单中的appid取自交易时候提交的appid，与请求下载对账单时使用的appid无关。
适用对象:直连模式机构模式
请求URL: https://api.mch.weixin.qq.com/pay/downloadbill
请求方式: POST
是否需要证书: 否
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 公众账号ID | appid | string(32) | 是 | 微信分配的公众账号ID 示例值：wx8888888888888888 |
| 商户号 | mch_id | string(32) | 是 | 微信支付分配的商户号 示例值：1900000109 |
| 随机字符串 | nonce_str | string(32) | 是 | 随机字符串，不长于32位。推荐随机数生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 签名 | sign | string(64) | 是 | 签名，详见签名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 签名类型 | sign_type | string(32) | 否 | 签名类型，目前支持HMAC-SHA256和MD5，默认为MD5 示例值：HMAC-SHA256 |
| 对账单日期 | bill_date | string(8) | 是 | 下载对账单的日期，格式：20140603 示例值：20140603 |
| 账单类型 | bill_type | string(8) | 否 | ALL:（默认值），返回当日所有订单信息（不含充值退款订单） SUCCESS:返回当日成功支付的订单（不含充值退款订单） REFUND:返回当日退款订单（不含充值退款订单） RECHARGE_REFUND:返回当日充值退款订单 示例值：ALL |
| 压缩账单 | tar_type | string(8) | 否 | 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。 示例值：GZIP |
<xml>
<appid>wx2421b1c4370ec43b</appid>
<bill_date>20141110</bill_date>
<bill_type>ALL</bill_type>
<mch_id>10000100</mch_id>
<nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
<sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>
失败时，返回以下字段
| 字段名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回状态码 | return_code | string(16) | 是 | FAIL 示例值：FAIL |
| 错误码描述 | return_msg | string(128) | 否 | 返回信息，如非空，为错误原因 如：签名失败 等。 示例值：签名失败 |
| 错误码 | error_code | string(16) | 否 | 失败错误码，详见错误码列表 示例值：20002 |
成功时，数据以文本表格的方式返回，第一行为表头，后面各行为对应的字段内容，字段内容跟查询订单或退款结果一致，具体字段说明可查阅相应接口。
第一行为表头，根据请求下载的对账单类型不同而不同(由bill_type决定), 目前有：
当日所有订单
交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,微信退款单号,
商户退款单号,退款金额, 代金券或立减优惠退款金额，退款类型，退款状态,商品名称,商户数据包,手续费,费率
当日成功支付的订单
交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额, 代金券或立减优惠金额,商品名称,商户数据包,手续费,费率
当日退款的订单
交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额, 代金券或立减优惠金额,退款申请时间,
退款成功时间,微信退款单号,商户退款单号,退款金额, 代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
从第二行起，为数据记录，各参数以逗号分隔，参数前增加`符号，为标准键盘1左边键的字符，字段顺序与表头一致。
倒数第二行为订单统计标题，最后一行为统计数据
总交易单数，总交易额，总退款金额，总代金券或立减优惠退款金额，手续费总金额
举例如下：
交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,微信退款单号,
商户退款单号,退款金额,代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
`2014-11-10 16：33：45,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1001690740201411100005734289,`1415640626,`085e9858e3ba5186aafcbaed1,`MICROPAY,`SUCCESS,
`OTHERS,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被扫支付测试,`订单额外描述,`0,`0.60%`2014-11-10 16：46：14,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1002780740201411100005729794,`1415635270,
`085e9858e90ca40c0b5aee463,`MICROPAY,`SUCCESS,`OTHERS,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被扫支付测试,`订单额外描述,`0,`0.60% 总交易单数,总交易额,总退款金额,总代金券或立减优惠退款金额,手续费总金额
`2,`0.02,`0.0,`0.0,`0
结算对账单
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 错误码 | 名称 | 描述 | 原因 | 解决方案 |
|---|---|---|---|---|
| 100 | SYSTEM_ERROR | 下载失败 | 系统超时 | 请尝试再次查询 |
| 100 | Network_Traffic_Limit | 网络流量限制 | 当前系统请求繁忙 | 请尝试再次查询 |
| 20003 | SYSTEM_ERROR | 下载失败 | 系统超时 | 请尝试再次查询 |
| 20001 | sign error | 签名错误 | 请求参数未按要求进行填写 | 签名错误，请重新检查参数和签名密钥是否正确 |
| nonce_str too long | 参数nonce_str错误 | 请求参数未按要求填写 | 参数nonce_str长度超长 | |
| invalid tar_type, Only GZIP supported | 参数tar_type错误 | 请求参数未按指引进行填写 | 请重新检查参数invalid tar_typ是否正确 | |
| invalid bill_type | 参数bill_type错误 | 请求参数未按指引进行填写 | 请重新检查参数bill_type是否正确 | |
| invalid bill_date | 参数bill_date错误 | 请求参数未按指引进行填写 | 请重新检查参数bill_date是否符合要求 | |
| require POST method | 请求方式错误 | 请求方式不符合要求 | 请求检查参数请求方式是否为post | |
| empty post data | 请求报文错误 | 请求报文为空 | 请重新检查请求报文是否正确 | |
| data format error | 参数格式错误 | 请求参数要求为xml格式 | 请重新检查请求参数格式是否为xml | |
| missing parameter | 缺少参数 | 有必传的参数未上传 | 请重新检查是否所有必传参数都上传了，且不为空 | |
| invalid appid | appid错误 | 请求参数appid有误 | 请重新检查参数appid是否正确 | |
| invalid parameter | 参数错误 | 有未知的请求参数 | 请重新检查是否所有参数都与文档相符 | |
| 20002 | NO Bill Exist | 账单不存在 | 当前商户号没有已成交的订单，不生成对账单 | 请检查当前商户号在指定日期内是否有成功的交易。 |
| Bill Creating | 账单未生成 | 当前商户号没有已成交的订单或对账单尚未生成 | 请先检查当前商户号在指定日期内是否有成功的交易，如指定日期有交易则表示账单正在生成中，请在上午10点以后再下载。 | |
| 20007 | 当前商户号账单API权限已经关闭 | 当前商户号账单API权限已经关闭 | 当前商户号账单API权限已经关闭 | 当前商户号账单API权限已经关闭，请联系微信支付解决 |
| 20008 | Frequency Limited | 请求频率超过限制 | 当前IP或商户号的请求过于频繁，超过了频率限制 | 请放慢请求速度，稍后再次查询 |
| 20100 | SYSTEM_ERROR | 下载失败 | 系统超时 | 请尝试再次查询 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证