跳到主要内容

批量付款明细单查询

查询商家批量转账中单笔转账明细单。

请求接口​

openapi/pay/fund/wxMchTransferBatchDetailQuery

公共参数​

接口协议 - 公共参数

请求参数​

以下两种方式之一传参：

  • batch_id + detail_id
  • out_batch_no + out_detail_no
参数必填类型说明
mchid是String(64)商家微信支付特约商户号
batch_id否String(64)微信支付批次单号
detail_id否String(64)微信明细单号
out_batch_no否String(32)商家批次单号
out_detail_no否String(32)商家明细单号

content请求实例​

:::: tabs ::: tab 微信返回单号传参

{
  "batch_id": "1030000071100999991182020050700019480001",
  "detail_id": "1040000071100999991182020050700019500100"
}

::: ::: tab 商户单号传参

{
  "out_batch_no": "20230520163067890",
  "out_detail_no": "2023052016306789001"
}

::: ::::

响应参数​

名称必填类型说明
mchid是String(64)商家微信支付特约商户号
out_batch_no是String(32)商家批次单号
batch_id是String(64)微信支付批次单号
appid否String(32)特约商户号绑定的appid。
out_detail_no是String(32)商家明细单号
detail_id是String(32)微信支付明细单号
detail_status是String(32)明细状态
PROCESSING：转账中。正在处理中，转账结果尚未明确
SUCCESS：转账成功
FAIL：转账失败。需要确认失败原因后，再决定是否重新发起对该笔明细单的转账（并非整个转账批次单）
transfer_amount是int转账金额，单位：分
transfer_remark是String(32)转账备注
fail_reason否String(64)明细失败原因
如果转账失败则有失败原因：
ACCOUNT_FROZEN：账户冻结
REAL_NAME_CHECK_FAIL：用户未实名
NAME_NOT_CORRECT：用户姓名校验失败
OPENID_INVALID：Openid校验失败
TRANSFER_QUOTA_EXCEED：超过用户单笔收款额度
DAY_RECEIVED_QUOTA_EXCEED：超过用户单日收款额度
MONTH_RECEIVED_QUOTA_EXCEED：超过用户单月收款额度
DAY_RECEIVED_COUNT_EXCEED：超过用户单日收款次数
PRODUCT_AUTH_CHECK_FAIL：产品权限校验失败
OVERDUE_CLOSE：转账关闭
ID_CARD_NOT_CORRECT：用户身份证校验失败
ACCOUNT_NOT_EXIST：用户账户不存在
TRANSFER_RISK：转账存在风险
openid是String(32)收款用户openid
username是String(32)收款用户姓名，敏感信息加密
initiate_time是String(32)转账发起时间，格式："yyyy-MM-dd HH:mm:ss"
update_time是String(32)明细更新时间，格式："yyyy-MM-dd HH:mm:ss"

响应示例​

{
  "mchid": "1900001109",
  "out_batch_no": "20230520163067890",
  "batch_id": "1030000071100999991182020050700019480001",
  "appid": "wxf636efh567hg4356",
  "out_detail_no": "2023052016306789001",
  "detail_id": "1040000071100999991182020050700019500100",
  "detail_status": "SUCCESS",
  "transfer_amount": 120000,
  "transfer_remark": "6月报销",
  "fail_reason": "ACCOUNT_FROZEN",
  "openid": "o-MYE42l80oelYMDE34nYD456Xoy",
  "username": "757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45",
  "initiate_time": "2023-05-20 16:33:35",
  "update_time": "2023-05-20 16:34:50"
}

错误描述说明​

公共返回码

错误描述解决方案
请求参数符合参数格式，但不符合业务规则查询单据超过限定时间(30天)，可以尝试通过商户平台预约下载
记录不存在查询的转账批次单不存在
频率超限请求量不要超过接口调用频率限制
预约咨询