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

返回上一层文档首页 / 查询转账电子回单API

查询转账电子回单API

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

查询转账电子回单接口，商户通过该接口可以查询电子回单受理进度信息，包括电子回单据信息，电子回单文件的hash值，电子回单文件的下载地址等

注意：

• 支持查询最近90天内的转账明批次单

接口说明

适用对象：直连商户

请求URL：https://api.mch.weixin.qq.com/v3/transfer/bill-receipt/{out_batch_no}

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
商家批次单号	out_batch_no	string[5, 32]	是	path商户系统内部的商家批次单号，在商户系统内部唯一。需要电子回单的批次单号示例值：plfk2020042013

请求示例

https://api.mch.weixin.qq.com/v3/transfer/bill-receipt/plfk2020042013


｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
商家批次单号	out_batch_no	string[5,32]	是	商户系统内部的商家批次单号，在商户系统内部唯一。需要电子回单的批次单号示例值：plfk2020042013
电子回单申请单号	signature_no	string[3,45]	是	电子回单申请单号，申请单据的唯一标识示例值：1050000010509999485212020110200058820001
电子回单状态	signature_status	string[1,10]	否	枚举值： ACCEPTED:已受理，电子签章已受理成功 FINISHED:已完成。电子签章已处理完成示例值：ACCEPTED
电子回单文件的hash方法	hash_type	string[1,20]	否	电子回单文件的hash方法，回单状态为：FINISHED时返回。示例值：SHA256
电子回单文件的hash值	hash_value	string[3,1000]	否	电子回单文件的hash值，用于下载之后验证文件的完整、正确性，回单状态为：FINISHED时返回。示例值：DE731F35146A0BEFADE5DB9D1E468D96C01CA8898119C674FEE9F11F4DBE5529
电子回单文件的下载地址	download_url	string[10,3000]	否	电子回单文件的下载地址，回单状态为：FINISHED时返回。URL有效时长为10分钟，10分钟后需要重新去获取下载地址示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx
创建时间	create_time	string[1, 32]	否	电子签章单创建时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒示例值：2020-05-20T13:29:35.120+08:00
更新时间	update_time	string[1, 32]	否	电子签章单最近一次状态变更的时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒示例值：2020-05-21T13:29:35.120+08:00

返回示例

正常示例


{
  "out_batch_no": "plfk2020042013",
  "signature_no": "1050000010509999485212020110200058820001",
  "signature_status": "ACCEPTED",
  "hash_type": "SHA256",
  "hash_value": "DE731F35146A0BEFADE5DB9D1E468D96C01CA8898119C674FEE9F11F4DBE5529",
  "download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx",
  "create_time": "2020-05-20T13:29:35.120+08:00",
  "update_time": "2020-05-21T13:29:35.120+08:00"
}


http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	重试
403	NO_AUTH	商户信息不合法	登录商户平台核对，传入正确信息
400	INVALID_REQUEST	参数错误或者不符合业务规则	传入正确参数
	PARAM_ERROR	参数错误	登录商户平台核对，输入正确参数
	ALREADY_EXISTS	订单已存在	该商家的电子回单已受理
429	FREQUENCY_LIMITED	频率超限	请降低频率重试

技术咨询

文档反馈