微信单号查询电子回单

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

transfer_bill_no 　必填 string(64)

【微信转账单号】 转账单据对应的微信支付单号

请求示例

GET

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

200 OK

state 　必填 string

【申请单状态】 GENERATING：生成中，FINISHED: 已完成，FAILED：已失败

可选取值

• GENERATING: 表示当前电子回单已受理成功并在处理中

• FINISHED: 表示当前电子回单已处理完成

• FAILED: 表示当前电子回单生成失败，失败原因字段会返回具体的失败原因

create_time 　必填 string(32)

【申请单创建时间】 申请单的创建时间，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE

update_time 　必填 string(32)

【申请单更新时间】 申请单最近的更新时间，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE

hash_type 　选填 string

【回单文件摘要类型】 申请单状态为已完成时返回

可选取值

• SHA256: SHA256摘要算法

• SM3: 国密SM3摘要算法

hash_value 　选填 string(512)

【回单文件摘要值】 申请单状态为已完成时返回，请务必将下载的回单文件摘要值与该值进行对比，以保证回单文件的完整性和真实性

download_url 　选填 string(3000)

【回单文件下载地址】 申请单状态为已完成时返回，有效期10分钟，过期后可以重新通过该接口获取；下载地址的域名，路径，参数都可能变化，请不要自行拼接

fail_reason 　选填 string

【失败原因】 申请单状态为已失败时返回

应答示例

200 OK

1{
2  "state" : "GENERATING",
3  "create_time" : "2015-05-20T13:29:35.120+08:00",
4  "update_time" : "2015-05-20T13:29:35.120+08:00",
5  "hash_type" : "SHA256",
6  "hash_value" : "DE731F35146A0BEFADE5DB9D1E468D96C01CA8898119C674FEE9F11F4DBE5529",
7  "download_url" : "https://api.mch.weixin.qq.com/v3/transferbilldownload/file?token=xxx",
8  "fail_reason" : "\"转账单据不存在\""
9}
10