主题
商户批量转账
接口描述
- 由商户发起，将商户资金转入到指定收款商户账户的过程。仅支持基本户转账。
请求URL
/batchTransfer/apply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS240820000054 |
| notifyUrl | 否 | string | 通知地址 | ||
| details | 是 | array | 批量转账明细,json数组字符串 | ||
| -outTransferNo | 是 | string | 商户转账申请单号 | ||
| -transferAmount | 是 | string | 转账金额，单位：分 | ||
| -payeeMerchantNo | 是 | string | 32 | 收款商户编号 | |
| -remark | 否 | string | 64 | 备注 |
请求报文示例
json
{"appId":"202415629590370906",
"details":"[{\"outTransferNo\":\"T2025072118120123\",\"transferAmount\":100,\"payeeMerchantNo\":\"XS250709000563\",\"remark\":\"测试\"}]",
"merchantNo":"XS250523000537", "notifyUrl":"https://xxxx.com","signature":"dQXaX6WInMfIigWHJpmFYqG6Dl7eS56s0atQO1V8mv0nqk8Lx4CMfCT0LLUhZ7fxogKrq2njIxebG7m/aBICKzOpeAV4gLlPA/pZH0glsLpVNh39OMT4Jaz6iVF2DPqfCZDHR6MQHha8/8nM9yRkVUT84vXePS7Myqi65qw9Lo2rjrHadzIx0l3sSGDXy0mB5gILjdRhdrbx6jNfIQb+7KSKoIf5A+6CKCCzXwGgXQNJXMZyFE71dQmtmiaTJWwhQ9x4AAGTC3rftOAFgcIE7GzbAMHbmHHwAPgjN53B/vbxlCd44z+Ws0kT13hzl44TizYoaa85Eq75M+Y6+wg92w==","transDate":"1753070143569","transNonce":"bca891db12a04361ac1a92b7f303e636"}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| batchNo | 是 | string | 32 | 支付系统批次号 | 35202507211947123444651393026 |
| details | 是 | array | 批量转账明细,json数组字符串 | ||
| -outTransferNo | 是 | string | 商户转账申请单号 | ||
| -transferNo | 是 | string | 平台单号 | ||
| -orderStatus | 是 | string | 状态：INIT:初始,TRANSFERING:转账处理中,SUCCESS:成功,CLOSE:关闭 | ||
| -transferAmount | 是 | string | 转账金额，单位：分 | ||
| -payeeMerchantNo | 是 | string | 32 | 收款商户编号 | |
| -remark | 否 | string | 64 | 备注 |
响应示例
json
{"signature":"YptIdKEvWcwc3rVUCK4zoabPPgiEKI889XdvcEFOIOygcKnUQjRb5Osm6NKFuBCSkmP+rx62nPdCre1chadQM4FltkV4ZykG6/LO5QrwL4zaTNLwjUlAdCHJb82mqRYI89ulIDJzdFGrZ5hMb5hc+yi0ZWt6BDOcpg2c9IMYBEdcaxC2FqztDQ2CvQJh1ag2G5Qhl1ugdvLuyl1ey4jpjkKKzBgL/8isz0syeQXWMWr8a1WiUV2/MTChaEOKWK73kIONSWOkOMXDahvkG26TJem5RcfZ2bdILJykRJFBPSAIbGQ3hbNpyJ4szKCeoDU7VRUTlN7xmZ6B8AtMPbrO1g==","code":"00000000","message":"成功","transNonce":"bca891db12a04361ac1a92b7f303e636","transDate":"1753070145777",
"batchNo":"35202507211947143434797772802",
"details":"[{\"orderStatus\":\"INIT\",\"outTransferNo\":\"T2025072118120123\",\"payeeMerchantNo\":\"XS250709000563\",\"remark\":\"测试\",\"transferAmount\":100,\"transferNo\":\"35202507221947604203065819137\"}]"
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述