批量付款到零钱
商户可以通过该接口同时向多个用户微信零钱进行转账操作。
提示
- 需开通微信支付“商家转账到零钱”功能。
- 支持微信支付普通商户模式下的特约商户向个人微信转账零钱。
- 转账收款人必须实名。
- 批量转账一旦发起后，不允许撤销，批次受理成功后开始执行转账。
- 当返回错误时，请不要更换商家批次单号，一定要使用原商家批次单号重试，否则可能造成重复转账等资金风险。
- 微信支付视任何不同“商家批次单号（out_batch_no）”的请求为一个全新的批次。在未查询到明确的转账批次单处理结果之前，请勿修改商家批次单号重新提交！
- 请调用方在自身的系统中合理设置转账频次并做好并发控制，防范错付风险。
- 因调用方自身系统设置存在问题导致的资金损失，由调用方自行承担。
请求接口
openapi/pay/fund/wxMchTransferBatch
公共参数
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mchid | 是 | String(64) | 商家微信支付特约商户号 |
| appid | 是 | String(32) | 微信特约商户号绑定的appid |
| out_batch_no | 是 | String(32) | 商家批次单号 |
| batch_name | 是 | String(32) | 批次名称 |
| batch_remark | 是 | String(32) | 批次备注 |
| total_amount | 是 | int | 转账总金额，单位：分 |
| total_num | 是 | int | 转账总笔数。一个转账批次单最多发起三千笔转账。 转账总笔数必须与批次内所有明细之和保持一致，否则无法发起转账操作。 |
| transfer_scene_id | 否 | String(32) | 转账场景ID。该批次转账使用的转账场景，如不填写则使用商家的默认场景，如无默认场景可为空，可前往“商家转账到零钱-前往功能”中申请。 如：1001 - 现金营销 |
| transfer_detail_list | 是 | array | 转账明细列表。发起批量转账的明细列表，最多三千笔。 |
transfer_detail_list列表参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| out_detail_no | 是 | String(32) | 商家明细单号 |
| transfer_amount | 是 | int | 转账金额，单位：分 |
| transfer_remark | 是 | String(32) | 转账备注 |
| openid | 是 | String(64) | 收款用户openid，appid下的唯一用户标识 |
| user_name | 是 | String(32) | 收款用户姓名 |
| user_id_card | 否 | String(32) | 收款用户身份证 |
content请求示例
{
"mchid": "1900000109",
"appid": "wxf636efh567hg4356",
"out_batch_no": "20230520163067890",
"batch_name": "2023年5月报销单",
"batch_remark": "2023年5月报销单",
"total_amount": 200000,
"total_num": 2,
"transfer_detail_list": [
{
"out_detail_no": "2023052016306789001",
"transfer_amount": 120000,
"transfer_remark": "5月报销",
"openid": "o-MYE42l80oelYMDE34nYD456Xoy",
"user_name": "张三",
"user_id_card": "440106200101011234"
},
{
"out_detail_no": "2023052016306789002",
"transfer_amount": 80000,
"transfer_remark": "5月报销",
"openid": "o-P9e-i32xciegIF9P2apz211ZP7",
"user_name": "李四",
"user_id_card": "440106200101019856"
}
]
}
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| out_batch_no | 是 | String(32) | 商家批次单号 |
| batch_id | 是 | String(32) | 微信支付批次单号 |
| create_time | 是 | String(32) | 批次创建时间，格式："yyyy-MM-dd HH:mm:ss" |
响应示例
{
"out_batch_no": "20230520163067890",
"batch_id": "1030000071100999991182020050700019480001",
"create_time": "2023-05-20 16:33:35"
}