下载电子回单
更新时间:2024.12.27下载电子回单API为通用接口,商家转账等业务电子回单均可通过该接口进行下载。
注意
- 电子回单文件的下载地址的有效时间为10分钟。
- 强烈建议商户将实际电子回单的哈希值和之前从接口获取到的哈希值进行比对,以确认数据的完整性。
特别注意:
调用该接口如果报错签名错误时,可按照如下步骤进行操作:
- 签名前的数据与URL上的数据进行对比,确认两者是否一致。
- 请求报文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+nGzX3hfZg6r55wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI61XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al7LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/84nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'
# 返回参数
# 文件格式说明
批量转账汇总明细电子回单,包含批次汇总信息,如总笔数、总金额等,也包含批次中的单笔明细信息。具体示例如下:
《批量转账汇总明细电子回单》 (opens new window)
《批量转账明细电子回单》 (opens new window)
文档是否有帮助