接口链接:https://api.mch.weixin.qq.com/pay/downloadbill
商户可以通过该接口下载历叱交易清单。某些情冴,比如掉单、交易错误,导致商户侧和微信侧数据丌一致,通过对账单核对后可校正支付状态。
注意:
请求参数:
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 公众账号 | ID appid | 是 | String(32) | 微信分配的公众账号 ID |
| 商户号 | mch_id | 是 | String(32) | 微信支付分配的商户号 |
| 设备号 | device_info | 否 | String(32) | 微信支付分配的终端设备号,填写此字段,只下载该设备号的对账单 |
| 随机字符串 | nonce_str | 是 | String(32) | 随机字符串,不长于 32 位 |
| 签名 | sign | 是 | String(32) | 签名,详细签名方法见 2.2 节 |
| 对账单日起 | bill_date | 是 | String(8) | 下载对账单的日期,格式:20140603 |
| 账单类型 | bill_type | 否 | String(8) | ALL,返回当日所有订单信息,默认值SUCCESS,返回当日成功支付的订单REFUND,返回当日退款订单 |
同步返回结果:
失败时,返回以下字段
| 字段名 | 变量名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 返回状态码 | return_code | 是 | String(16) | FAIL |
| 返回信息 | return_msg | 否 | String(128) | 返回信息,如非空,为错误原因签名失败参数格式校验错误该日期订单未生成 |
成功时,数据以文本表格的方式返回,第一行为表头,后面各行为对应的字段内容,字段内容跟查询订单戒退款结果一致,具体字段说明可查阅相应接口。
第一行为表头,根据请求下载的对账单类型丌同而丌同(由 bill_type 决定), 目前有:
当日所有订单
交易时间,公众账号 ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,现金券金额,微信退款单号,商户退款单号,退款金额,现金券退款金额,退款类型,退款状态,商品名称,商费率
当日成功支付的订单
交易时间,公众账号 ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,现金券金额,商品名称,商户数据包,手续费,费率
当日退款的订单
交易时间,公众账号 ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,现金券金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额,现金券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
从第二行起,为数据记录,各参数以逗号分隔,参数前增加`符号,为标准键盘1左边键的字符,字段顺序不表头一致。
倒数第二行为订单统计标题,最后一行为统计数据
总交易单数,总交额,总退款金额,总现金券退款金额,手续费总金额