批量转账明细查询
查询批量转账中单笔转账明细单。
提示
- 只支持查询最近30天内的转账。
- 转账明细单只会在批次单完成的情况下返回，如果需要在批次处理过程中查询转账明细单，请通过转账明细单查询接口来查询。
- 如果查询单号对应的数据不存在，那么数据不存在的原因可能是：
- 转账还在处理中；
- 转账批次单受理失败或还未开始处理导致转账明细单没有落地。
- 如果遇到回包返回不明确的错误码或错误信息，请务必不要换单重试，请联系客服确认转账情况。
请求接口
openapi/pay/fund/wxSpTransferBatchDetailQuery
公共参数
请求参数
以下两种方式之一传参：
- batch_id + detail_id
- out_batch_no + out_detail_no
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 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": "plfk20210611132926",
"out_detail_no": "plfk2021061113292601"
}
::: ::::
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| out_batch_no | 是 | String(32) | 商家批次单号 |
| batch_id | 是 | String(64) | 微信支付批次单号 |
| appid | 否 | String(32) | 微信分配的特约商户公众账号ID。 特约商户授权类型为 INFORMATION_AUTHORIZATION_TYPE和INFORMATION_AND_FUND_AUTHORIZATION_TYPE时对应的是特约商户的appid， 特约商户授权类型为FUND_AUTHORIZATION_TYPE时为服务商的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" |
响应示例
{
"sp_mchid": "1900001109",
"out_batch_no": "plfk20210611132926",
"batch_id": "1030000071100999991182020050700019480001",
"appid": "wxf636efh567hg4356",
"out_detail_no": "plfk2021061113292601",
"detail_id": "1040000071100999991182020050700019500100",
"detail_status": "SUCCESS",
"transfer_amount": 120000,
"transfer_remark": "6月报销",
"fail_reason": "ACCOUNT_FROZEN",
"openid": "o-MYE42l80oelYMDE34nYD456Xoy",
"username": "757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45",
"initiate_time": "2021-06-11 13:29:35",
"update_time": "2021-06-11 13:30:28"
}
错误描述说明
| 错误描述 | 解决方案 |
|---|---|
| 请求参数符合参数格式，但不符合业务规则 | 查询单据超过限定时间(30天)，可以尝试通过商户平台预约下载 |
| 记录不存在 | 查询的转账批次单不存在 |
| 频率超限 | 请求量不要超过接口调用频率限制 |