微信支付合作伙伴平台

接口说明

适用对象：服务商 电商平台

请求URL：通过申请账单接口获取到“download_url”，URL有效期30s

请求方式：GET

前置条件：调用申请账单接口并获取到“download_url”

请求参数

当获取到账单文件资源的下载地址信息后，如：

{
 "hash_type": "SHA1",
 "hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
 "download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
}

可以通过微信支付API v3标准对download_url进行签名，并发起请求，即可下载到账单文件的数据流。

$ curl https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx -H '
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900009191",
nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",
signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5
wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'

返回参数

交易账单格式说明

1. 交易账单介绍

微信支付每天提供前一天的交易账单文件，用于商户核对订单、退款、营销、手续费等信息。账单内的数据包括：

（1）当天支付成功的订单，下单成功但用户未支付的订单不会出账。

（2）当天发起退款成功的退款单，退款发起成功就会出账，出账后退款状态不会更新。如果需要获取最新退款状态，请使用查询单笔退款API查询。

2. 交易账单的文件格式

交易账单文件内包含：明细数据表头、明细数据内容、汇总数据表头、汇总数据四个部分，每个字段使用英文逗号 , 间隔，明细数据内容每个字段前会增加1个字符 ` 用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节。3份不同类型的账单文件字段内容略有差异。

2.1. ALL类型账单文件具体字段

2.2. SUCCESS和REFUND账单

SUCCESS和REFUND账单的字段和ALL账单内略有不同

SUCCESS账单字段：交易时间,公众账号ID,商户号,特约商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,商品名称,商户数据包,手续费,费率,订单金额,费率备注

REFUND账单字段：交易时间,公众账号ID,商户号,特约商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额,充值券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率,订单金额,申请退款金额,费率备注

2.3. 特殊字符转义

账单处理过程会对商品名称、商户数据包、设备号等商户自定义字段进行特殊字符转义，具体规则包括：

'转换成为\'

"转换成为\"

`转换成为\`

,转换成为\ （\+空格）

\r转换成为\\r

\t转换成为\\t

2.4. 补充说明

少部分商户目前的账单格式停留在历史早期版本，具体表现为：没有应结算订单金额字段、对应的是总金额字段，没有代金券金额字段、对应的是企业红包金额字段。如需调整为最新格式的账单，可以通过在产品中心中开通免充值优惠券功能，次日开始的账单格式即会完成变更。

3. 账单样例

《ALL.xlsx》、《REFUND.xlsx》、《SUCCESS.xlsx》

资金流水账单

《资金账单.xlsx》

错误码公共错误码