商家批次单号查单接口。商户可以通过该接口查询转账批次单以及指定状态的转账明细单。返回消息中包含微信批次单号、批次状态、批次类型、转账总金额、转账总笔数、成功金额、失败金额等信息。

接口说明

支持商户：

【平台商户】

请求方式：

【GET】/v3/platsolution/mch-transfer/batches/out-batch-no/{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)
【商家批次单号】 服务商系统内部的批次单号，在服务商系统内部唯一

Query 查询参数
sub_mchid 必填 string(32)
【二级商户号】 二级商户号
need_query_detail 必填 boolean
【是否查询转账明细单】 true-是；false-否，默认否。商户可选择是否查询指定状态的转账明细单，当转账批次单状态为“FINISHED”（已完成）时，才会返回满足条件的转账明细单
offset 选填 integer
【请求资源起始位置】 该次请求资源（转账明细单）的起始位置，从0开始，默认值为0
limit 选填 integer
【最大资源条数】 该次请求可返回的最大资源（转账明细单）条数，最小20条，最大100条，不传则默认20条。不足20条按实际条数返回
detail_state 选填 string
【明细状态】 查询指定状态的转账明细单。
可选取值：

• ALL: 全部。查询批次下所有明细单
• WAIT_PAY: 待二级商户员工（转账验密人）确认, 符合免确认条件时, 系统会自动扭转为转账中
• SUCCESS: 转账成功
• FAIL: 需要确认失败原因后，再决定是否重新发起对该笔明细单的转账（并非整个转账批次单）
• BANK_REFUND: 银行返回转账成功后，拒绝入账，资金会返回商户账户。

请求示例

GET

应答参数

200OK
transfer_batch 必填 TransferBatchInfo
【转账批次单】 转账批次单基本信息
• 属性
data 选填 array[TransferDetailBrief]
【转账明细单列表】 当批次状态为“FINISHED”（已完成），且成功查询到转账明细单时返回。包括微信明细单号、明细状态信息
• 属性
offset 选填 integer
【请求资源起始位置】 该次请求资源（转账明细单）的起始位置，从0开始，默认值为0
limit 选填 integer
【最大资源条数】 该次请求可返回的最大资源（转账明细单）条数，最小20条，最大100条，不传则默认20条。不足20条按实际条数返回

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	无效请求	请根据接口返回的详细信息检查您的程序
403	NO_AUTH	商户暂无权限使用此功能	请开通商户号权限。请联系产品或商务申请
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率
500	SYSTEM_ERROR	接口返回错误	系统异常，请用相同参数重新调用