商家转账到零钱-文档中心-微信支付商户平台

返回上一层文档首页 / 下载电子回单API

下载电子回单API

最新更新时间：2021.10.26 版本说明

下载电子回单API为通用接口，商家转账等业务电子回单均可通过该接口进行下载。

注意：

• 电子回单文件的下载地址的有效时间为10分钟。

• 强烈建议商户将实际电子回单的哈希值和之前从接口获取到的哈希值进行比对，以确认数据的完整性。

特别注意：

调用该接口如果报错签名错误时，可按照如下步骤进行操作：
1. 签名前的数据与URL上的数据进行对比，确认两者是否一致。
2. 请求报文body后面没有换行符

接口说明

适用对象：直连商户

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

请求方式：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/transferdownload/signfile?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"'

返回参数

文件格式说明

批量转账汇总明细电子回单，包含批次汇总信息，如总笔数、总金额等，也包含批次中的单笔明细信息。具体示例如下：