批次管理 · V2.0.0
批次支付结果查询 BATCH_PAYMENT_RESULT_QUERY
用于批次支付结果查询的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
接口价值
批次结算能力
功能对应
用于批次支付结果查询的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
业务价值
适合串联结算批次发起、审批、支付、结果查询、回单和异常明细处理，便于系统化管理批次状态。
适合接入
适合需要把相关业务能力嵌入自有平台、SaaS、园区系统或企业内部系统的技术团队。具体业务适用性应结合真实场景与正式合作范围确认。
调用规范
公共调用信息
传输协议HTTPS
请求方式POST
报文格式JSON
字符集UTF-8
批次管理批次支付发起
批次管理失败批次明细换卡支付发起
公共请求参数
| 参数名称 | 参数说明 | 类型 | 长度 | 约束 | 说明 |
|---|---|---|---|---|---|
firstProviderCode | 一级服务商编号 | String | 18 | M | 由平台分配 |
secondProviderCode | 二级服务商编号 | String | 18 | O | 由平台分配 |
M = 必填，O = 选填，C = 条件必填。除特殊说明外参数类型均为 String；金额字段单位为元，并保留两位小数。
字段定义
业务请求参数
请求参数
| 参数名称 | 参数说明 | 长度 | 约束 | 描述 |
|---|---|---|---|---|
| batchCode | 批次编号 | 32 | M |
请求子结构 1
| 字段1 | 字段2 | 字段3 | 字段4 | 字段5 |
|---|---|---|---|---|
| enterpriseCode | 用工企业编号 | 32 | M | 5.2.2 查询获取 |
字段定义
业务响应参数
响应参数
| 参数名称 | 参数说明 | 说明 |
|---|---|---|
| batchCode | 批次编号 | |
| batchStatus | 批次状态 | 批次状态（5：待发放；6：发放中；7：发放 完成；8：发放异常） |
| totalCount | 总笔数 | 批次详单人员总记录数 |
| successCount | 成功笔数 | 批次详单下发成功笔数 |
| failureCount | 失败笔数 | 批次详单下发失败笔数 |
| batchDetails | 批次明细 | 结构体（多记录）JsonArray 成功和失败明细 都返回 |
响应子结构 1
| 参数名称 | 参数说明 | 描述 |
|---|---|---|
| batchDetailCode | 批次明细编号 | |
| payeeName | 收款方姓名 | |
| payeeIdCardNo | 收款方身份证号 | |
| payeePhone | 收款方手机号 | |
| payeeAcctNo | 收款方账号 | |
| payeeAmount | 收款方金额 | |
| transAmount | 交易金额 | |
| transRemark | 交易备注 | |
| transStatus | 交易状态 | |
| errorMessage | 错误信息 | |
| serviceFee | 服务费 | |
| individualTax | 个税 | |
| valueAddedTax | 增值税 | |
| prepaidIndividualTax | 已预缴个税 | |
| prepaidValueAddedTax | 已预缴增值税 | |
| payeeIdCardNoMask | 收款方身份证号（脱敏） | |
| payeeAcctNoMask | 收款方账号（脱敏） |
FAQ
常见问题
BATCH_PAYMENT_RESULT_QUERY 接口是做什么的？
用于批次支付结果查询的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
调用 BATCH_PAYMENT_RESULT_QUERY 前需要了解什么？
开放平台统一使用 HTTPS，通过 POST 调用 /openapi/v2/access-provider，请求和响应采用 JSON、UTF-8；公共请求参数包含 firstProviderCode（必填）和 secondProviderCode（选填）。具体报文结构、签名和加密规则以平台提供的正式接口手册/JAR包为准。
基于《开放平台接口 V2.0》正文整理，当前修订版本 V2.0.0，修订日期 2026-06-09。页面仅对附件中明确给出的接口字段进行结构化展示，不自行补造未提供的请求/响应定义。