最新更新时间：2021.10.26 版本说明
查询转账明细电子回单受理结果接口，商户通过该接口可以查询电子回单受理进度信息，包括电子回单据信息，电子回单文件的hash值，电子回单文件的下载地址等。
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/transfer-detail/electronic-receipts
请求方式：GET
前置条件：只支持查询最近90天内的转账明细单
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 受理类型 | accept_type | string[1,32] | 是 | query电子回单受理类型： BATCH_TRANSFER：批量转账明细电子回单 TRANSFER_TO_POCKET：企业付款至零钱电子回单 TRANSFER_TO_BANK：企业付款至银行卡电子回单 示例值：BATCH_TRANSFER |
| 商家转账批次单号 | out_batch_no | string[5, 32] | 否 | query需要电子回单的批量转账明细单所在的转账批次单号，该单号为商户申请转账时生成的商户单号。受理类型为BATCH_TRANSFER时该单号必填，否则该单号留空。 示例值：GD2021011610162610BBdkkIwcu3 |
| 商家转账明细单号 | out_detail_no | string[5, 32] | 是 | query该单号为商户申请转账时生成的商家转账明细单号。 1.受理类型为BATCH_TRANSFER时填写商家批量转账明细单号。 2. 受理类型为TRANSFER_TO_POCKET或TRANSFER_TO_BANK时填写商家转账单号。 示例值：mx0911231610162610v4CNkO4HAf |
https://api.mch.weixin.qq.com/v3/transfer-detail/electronic-receipts?accept_type=BATCH_TRANSFER&out_batch_no=GD2021011610162610BBdkkIwcu3&out_detail_no=mx0911231610162610v4CNkO4HAf
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 受理类型 | accept_type | string[1,32] | 是 | 电子回单受理类型： BATCH_TRANSFER：批量转账明细电子回单 TRANSFER_TO_POCKET：企业付款至零钱电子回单 TRANSFER_TO_BANK：企业付款至银行卡电子回单 示例值：BATCH_TRANSFER |
| 商家转账批次单号 | out_batch_no | string[5, 32] | 否 | 需要电子回单的批量转账明细单所在的转账批次单号，该单号为商户申请转账时生成的商户单号。受理类型为BATCH_TRANSFER时该单号必填，否则该单号留空。 示例值：GD2021011610162610BBdkkIwcu3 |
| 商家转账明细单号 | out_detail_no | string[5, 32] | 是 | 该单号为商户申请转账时生成的商家转账明细单号。 1.受理类型为BATCH_TRANSFER时填写商家批量转账明细单号。 2. 受理类型为TRANSFER_TO_POCKET或TRANSFER_TO_BANK时填写商家转账单号。 示例值：mx0911231610162610v4CNkO4HAf |
| 电子回单受理单号 | signature_no | string[3, 256] | 是 | 电子回单受理单号，受理单据的唯一标识 示例值：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 |
{
"accept_type": "BATCH_TRANSFER",
"out_batch_no": "GD2021011610162610BBdkkIwcu3",
"out_detail_no": "mx0911231610162610v4CNkO4HAf",
"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"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
| 403 | NO_AUTH | 商户信息不合法 | 登录商户平台核对，传入正确信息 | 400 | INVALID_REQUEST | 参数错误或者不符合业务规则 | 传入正确参数 |
| PARAM_ERROR | 参数错误 | 登录商户平台核对，输入正确参数 | |
| ALREADY_EXISTS | 订单已存在 | 该商家的电子回单已受理 | |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请降低频率重试 |