发起商家转账

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

Content-Type 　必填　string

Wechatpay-Serial 　必填　string

请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

appid 　必填 string(32)

【商户appid】申请商户号的appid或商户号绑定的appid（企业号corpid即为此appid）

out_batch_no 　必填 string(32)

【商家批次单号】商户系统内部的商家批次单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一

batch_name 　必填 string(32)

【批次名称】该笔批量转账的名称

batch_remark 　必填 string(32)

【批次备注】转账说明，UTF8编码，最多允许32个字符

total_amount 　必填 integer

【转账总金额】转账金额单位为“分”。转账总金额必须与批次内所有明细转账金额之和保持一致，否则无法发起转账操作

total_num 　必填 integer

【转账总笔数】一个转账批次单最多发起一千笔转账。转账总笔数必须与批次内所有明细之和保持一致，否则无法发起转账操作

transfer_detail_list 　必填 array[TransferDetailInput]

【转账明细列表】发起批量转账的明细列表，最多一千笔

属性

out_detail_no 　必填 string(32) 【商家明细单号】商户系统内部区分转账批次单下不同转账明细单的唯一标识，要求此参数只能由数字、大小写字母组成 transfer_amount 　必填 integer 【转账金额】转账金额单位为“分” transfer_remark 　必填 string(32) 【转账备注】单条转账备注（微信用户会收到该备注），UTF8编码，最多允许32个字符 openid 　必填 string(64) 【收款用户openid】商户appid下，某用户的openid user_name 　选填 string(1024) 【收款用户姓名】收款方真实姓名。支持标准RSA算法和国密算法，公钥由微信侧提供 明细转账金额<0.3元时，不允许填写收款用户姓名 明细转账金额 >= 2,000元时，该笔明细必须填写收款用户姓名 同一批次转账明细中的姓名字段传入规则需保持一致，也即全部填写、或全部不填写 若商户传入收款用户姓名，微信支付会校验用户openID与姓名是否一致，并提供电子回单

transfer_scene_id 　选填 string(36)

【转账场景ID】该批次转账使用的转账场景，如不填写则使用商家的默认场景，如无默认场景可为空，可前往“商家转账到零钱-前往功能”中申请。
如：1001-现金营销

notify_url 　选填 string(256)

【通知地址】异步接收微信支付结果通知的回调地址，通知url必须为公网可访问的url，必须为https，不能携带参数。

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/transfer/batches \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "appid" : "wxf636efh567hg4356",
9    "out_batch_no" : "plfk2020042013",
10    "batch_name" : "2019年1月深圳分部报销单",
11    "batch_remark" : "2019年1月深圳分部报销单",
12    "total_amount" : 4000000,
13    "total_num" : 200,
14    "transfer_detail_list" : [
15      {
16        "out_detail_no" : "x23zy545Bd5436",
17        "transfer_amount" : 200000,
18        "transfer_remark" : "2020年4月报销",
19        "openid" : "o-MYE42l80oelYMDE34nYD456Xoy",
20        "user_name" : "757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45"
21      }
22    ],
23    "transfer_scene_id" : "1000",
24    "notify_url" : "https://www.weixin.qq.com/wxpay/pay.php"
25  }'
26

out_batch_no 　必填 string(32)

【商家批次单号】商户系统内部的商家批次单号，在商户系统内部唯一

batch_id 　必填 string(64)

【微信批次单号】微信批次单号，微信商家转账系统返回的唯一标识

create_time 　必填 string(32)

【批次创建时间】批次受理成功时返回，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE

batch_status 　选填 string

【批次状态】ACCEPTED:已受理。批次已受理成功，即将进入转账中。若发起30分钟后仍处于该状态，可能原因是商户账户余额不足等。在24小时内充值充足资金将继续执行转账，请再次查单确认状态。
PROCESSING:转账中。已开始处理批次内的转账明细单
FINISHED:已完成。批次内的所有转账明细单都已处理完成
CLOSED:已关闭。可查询具体的批次关闭原因确认

应答示例

1{
2  "out_batch_no" : "plfk2020042013",
3  "batch_id" : "1030000071100999991182020050700019480001",
4  "create_time" : "2015-05-20T13:29:35.120+08:00",
5  "batch_status" : "ACCEPTED"
6}
7