下载电子回单

更新时间:2024.12.27

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

注意

  • 电子回单文件的下载地址的有效时间为10分钟。
  • 强烈建议商户将实际电子回单的哈希值和之前从接口获取到的哈希值进行比对,以确认数据的完整性。

特别注意:

调用该接口如果报错签名错误时,可按照如下步骤进行操作:

  1. 签名前的数据与URL上的数据进行对比,确认两者是否一致。
  2. 请求报文body后面没有换行符

# 接口说明

支持商户: 【服务商】

请求方式: 【GET】

请求URL: 通过查询汇总电子回单受理结果 (opens new window)接口、查询明细电子回单受理结果 (opens new window)接口获取到“download_url”,URL有效期10min

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

# 请求参数

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

请求示例

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

可以通过微信支付API v3标准对通过查单获取到的download_url进行签名,并发起请求,即可下载到电子回单文件的数据流。

示例

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

# 返回参数

# 文件格式说明

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

《批量转账汇总明细电子回单》 (opens new window)

《批量转账明细电子回单》 (opens new window)

《企业付款到零钱电子回单》 (opens new window)

《企业付款到银行卡电子回单》 (opens new window)

更多技术问题
技术咨询
反馈
咨询
目录

微信支付文档中心已升级,你当前所查看的是旧文档中心的内容,旧文档中心将于 2025年 3 月 31日 下线,请移步 [新文档中心] 查看相应的内容