受理商家转账

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

body 包体参数

sub_mchid 　必填 string(32)

【二级商户号】 微信支付分配的商户号，出资商户号

sp_appid 　必填 string(32)

【服务商AppID】 服务商绑定的公众号ID。使用预约单号发起转账时，需要与预约时传入的服务商AppID为同一个。

sub_appid 　选填 string(32)

【二级商户AppID】 二级商户授权服务商绑定的公众号ID。使用预约单号发起转账时，需要与预约时传入的二级商户AppID为同一个。

out_batch_no 　必填 string(32)

【商家批次单号】 服务商系统内部的批次单号，只能由数字、大小写字母组成，在服务商系统内部唯一。

batch_name 　必填 string(32)

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

batch_remark 　必填 string(32)

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

total_amount 　必填 integer

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

total_num 　必填 integer

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

transfer_scene_id 　必填 string(36)

【转账场景ID】 指定该笔转账使用的转账场景ID，使用预约单号发起转账时，需要与预约时传入的转账场景ID为同一个。

transfer_detail_list 　必填 array[TransferDetailInfo]

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

	属性
	out_detail_no 　必填 string(32) 【商家明细单号】 服务商系统内部区分转账批次单下不同转账明细单的唯一标识，要求此参数只能由数字、大小写字母组成 transfer_amount 　必填 integer 【转账金额】 转账金额单位为“分”，若预约时指定了该次预约为准确的金额，则转账金额必须等于预计转账金额，若没有指定为准确的金额，转账金额可以小于等于预计转账金额。 transfer_remark 　必填 string(32) 【转账备注】 单条转账备注（微信用户会收到该备注），UTF8编码，最多允许32个字符 reservation_id 　必填 string(64) 【微信转账预约单号】 微信商家转账系统返回的预约记录唯一标识 openid 　必填 string(64) 【收款用户OpenID】 使用预约单号发起转账时，需填入预约时传入的openID

notify_url 　必填 string(256)

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

请求示例

POST

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

200 OK

out_batch_no 　必填 string(32)

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

batch_id 　必填 string(64)

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

create_time 　必填 string(32)

【批次创建时间】 批次受理成功时返回
使用rfc3339所定义的格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2023-02-23T13:29:35+08:00表示，北京时间2023年2月23日 13点29分35秒

batch_state 　选填 string

【批次状态】 商家转账批次单状态

可选取值

• ACCEPTED: 批次已受理成功，若发起批量转账的30分钟后，转账批次单仍处于该状态，可能原因是出资商户账户余额不足等。商户可查询账户资金流水，若该笔转账批次单的扣款已经发生，则表示批次已经进入转账中，请再次查单确认

• PROCESSING: 已开始处理批次内的转账明细单

• COMPLETED: 批次内的所有转账明细单都已处理完成

• CLOSED: 可根据 close_reason 字段确认具体的批次关闭原因确认

应答示例

200 OK

1{
2  "out_batch_no" : "sjzz20230223",
3  "batch_id" : "131000011085109987515042023022300246500006",
4  "create_time" : "2023-02-23T13:29:35+08:00",
5  "batch_state" : "ACCEPTED"
6}
7