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

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

微工卡核身预下单（正式）

微工卡批量转账（查询批次状态）