查询转账电子回单

更新时间:2024.11.18

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

注意

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

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/transfer/bill-receipt/{out_batch_no}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


path 路径参数

out_batch_no  必填 string(32)

【商家批次单号】 商户系统内部的商家批次单号,在商户系统内部唯一。需要电子回单的批次单号

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/transfer/bill-receipt/plfk2020042013 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 

应答参数

200 OK

out_batch_no  必填 string(32)

【商家批次单号】 商户系统内部的商家批次单号,在商户系统内部唯一。需要电子回单的批次单号


signature_no  必填 string(32)

【电子回单申请单号】 电子回单申请单号,申请单据的唯一标识


signature_status  必填 string

【电子回单状态】 枚举值:
ACCEPTED:已受理,电子签章已受理成功
FINISHED:已完成。电子签章已处理完成


hash_type  必填 string(32)

【电子回单文件的hash方法】 电子回单文件的hash方法,回单状态为:FINISHED时返回。


hash_value  必填 string(32)

【电子回单文件的hash值】 电子回单文件的hash值,用于下载之后验证文件的完整、正确性,回单状态为:FINISHED时返回。


download_url  必填 string(32)

【电子回单文件的下载地址】 电子回单文件的下载地址,回单状态为:FINISHED时返回。URL有效时长为10分钟,10分钟后需要重新去获取下载地址


create_time  必填 string(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秒


update_time  必填 string(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秒

应答示例

200 OK

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

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

参数错误或者不符合业务规则

传入正确参数

403

NO_AUTH

商户信息不合法

登录商户平台核对,传入正确信息

400

ALREADY_EXISTS

订单已存在

该商家的电子回单已受理

429

FREQUENCY_LIMITED

频率超限

请降低频率重试

 

 

反馈
咨询
目录
置顶