转账电子回单申请受理
更新时间：2024.12.27转账电子回单申请受理接口，商户通过该接口可以申请受理电子回单服务。
注意
- 发起转账时传入了收款用户姓名，支持申请电子回单；
- 支持受理最近30天内的转账明批次单；
- 仅支持已完成状态且至少一笔成功记录的批次获取电子回单(不满足条件返回：400 INVALID_REQUEST)；
# 接口说明
支持商户： 【普通服务商】
请求方式： 【POST】
请求URL： /v3/transfer/bill-receipt
接口限频： 单个商户 20QPS，如果超过频率限制，会报错FREQUENCY_LIMITED，请降低频率请求。
# 请求参数
- out_batch_no 必填【商家批次单号】 商户系统内部的商家批次单号，在商户系统内部唯一。需要电子回单的批次单号
Body 包体参数
# 返回参数
- out_batch_no 必填【商家批次单号】 商户系统内部的商家批次单号，在商户系统内部唯一。需要电子回单的批次单号
- signature_no 必填【电子回单申请单号】 电子回单申请单号，申请单据的唯一标识。
- signature_status 必填【电子回单状态】 枚举值：ACCEPTED:已受理，电子签章已受理成功FINISHED:已完成。电子签章已处理完成
- hash_type 必填【电子回单文件的hash方法】 电子回单文件的hash方法，回单状态为：FINISHED时返回。
- hash_value 必填【电子回单文件的hash值】 电子回单文件的hash值，用于下载之后验证文件的完整、正确性，回单状态为：FINISHED时返回。
- download_url 必填【电子回单文件的下载地址】 电子回单文件的下载地址，回单状态为：FINISHED时返回。URL有效时长为10分钟，10分钟后需要重新去获取下载地址
- create_time 必填【创建时间】 电子签章单创建时间，遵循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 必填【更新时间】 电子签章单最近一次状态变更的时间，遵循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秒
请求示例
1{2 "out_batch_no": "plfk2020042013"3}返回示例
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 | 频率超限 | 请降低频率重试 |
文档是否有帮助
