1. 微工卡
新运微信服务商API
  • 微信服务商API
    • 新运微信服务商API
    • 签名生成详细规则
    • 错误码文档
    • 微工卡接入流程
    • 批量转账
      • 批量转账（创建批次）
      • 查询批量转账状态（out_batch_no）
      • 查询批量转账状态（batch_id）
      • 查询批量转账明细（out_batch_no）
      • 查询批量转账明细（batch_id）
      • 查询批量转账明细（微信分页 wrapper）
      • 查询批量转账明细（batch_id，微信分页 wrapper）
    • 微工卡
      • 查询微工卡授权状态
        GET
      • 生成微工卡授权token
        POST
      • 查询核身结果
        GET
      • 拉起微工卡（授权并使用）
        POST
      • 拉起微工卡（查看我的微工卡）
        POST
      • 微工卡核身预下单（正式）
        POST
      • 微工卡批量转账（创建批次）
        POST
      • 微工卡批量转账（查询批次状态）
        GET
      • 微工卡批量转账（查询批次明细）
        GET
      • 微工卡批量转账电子回单受理（占位）
        POST
      • 微工卡批量转账电子回单状态（内部原始记录）
        GET
      • 微工卡批量转账电子回单下载链接
        GET
    • 商户回调
      • 批次状态变化回调（平台 -> 商户）
    • 数据模型
      • Schemas
        • ApiResponse_Error
        • ApiResponse_WechatError
        • ApiResponse_String
        • ApiResponse_BatchTransferResponse
        • ApiResponse_QueryBatchTransferResponse
        • ApiResponse_TransferDetailResponseList
        • ApiResponse_QueryBatchTransferDetailsResponse
        • ApiResponse_PayrollAuthTokenResponse
        • ApiResponse_PayrollAuthStatusResponse
        • ApiResponse_PayrollLaunchResponse
        • ApiResponse_PayrollFaceVerify
        • ApiResponse_BatchTransferRecord
        • ApiResponse_BatchTransferDetailList
        • WechatNotifyResponse
        • BatchTransferResponse
        • QueryBatchTransferResponse
        • TransferDetailResponse
        • QueryBatchTransferDetailsResponse
        • CreatePartnerTransferBatchRequest
        • CreatePayrollTransferBatchRequest
        • PayrollAuthTokenRequest
        • PayrollAuthTokenResponse
        • PayrollAuthStatusResponse
        • PayrollLaunchResponse
        • PayrollFacePreorderRequest
        • PayrollFaceVerify
        • BatchTransferRecord
        • BatchTransferCallbackDTO
      • Response
        • BadRequest
        • Unauthorized
        • Forbidden
        • NotFound
        • Conflict
        • RateLimitExceeded
        • WechatPayError
  1. 微工卡

微工卡批量转账（创建批次）

POST
/api/v1/payroll-card/transfer/batch/create
发起微工卡批量转账（创建批次）。
限流：每商户每秒 5 次（5 QPS）
注意事项：
使用微信官方 SDK CreateTransferBatchRequest 类型
批量转账一旦发起后，不允许撤销
相同"商户号+商家批次单号"的请求视为同一批次（幂等）
遇到错误时，不要更换商家批次单号重试
callbackUrl 通过 query 参数传入，批次进入终态时平台会回调通知商户

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功
application/json
成功
Body

🟠400请求有误
🟠401未认证
🟠403权限不足
🟠409冲突
🟠429请求过多
🔴500服务器内部错误
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/payroll-card/transfer/batch/create?callbackUrl' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Client-Id;' \
--header 'X-Biz-Merchant-Id;' \
--header 'X-App-Id;' \
--header 'X-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subMchid": "string",
    "subAppid": "string",
    "authorizationType": "string",
    "outBatchNo": "string",
    "batchName": "string",
    "batchRemark": "string",
    "totalAmount": 0,
    "totalNum": 0,
    "transferDetailList": [
        {
            "outDetailNo": "string",
            "transferAmount": 0,
            "transferRemark": "string",
            "openid": "string",
            "userName": "string"
        }
    ],
    "employmentType": "string",
    "employmentScene": "string"
}'
响应示例响应示例
200 - 示例 1
{
    "success": true,
    "code": "SUCCESS",
    "message": "成功",
    "data": {
        "outBatchNo": "string",
        "batchId": "string",
        "createTime": "string"
    }
}
修改于 2026-01-08 09:29:05
上一页
微工卡核身预下单（正式）
下一页
微工卡批量转账（查询批次状态）
Built with