基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(公共API)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
代扣服务切卡组件
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
商家转账到零钱
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传
微信支付平台证书

下载电子回单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-RSA2048mchid="1900009191",
nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",
signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5
wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'

返回参数

文件格式说明

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


《商家转账汇总明细电子回单》

《商家转账明细电子回单》

《企业付款到零钱电子回单》

《企业付款到银行卡电子回单》



技术咨询

文档反馈