批量转账发起

微信特约商户批量向用户零钱进行转账操作。

提示

支持微信支付服务商模式下的特约商户转账。
转账收款人必须实名。
接口调用前需与微信服务商明确授权模式，共有三种：
1. INFORMATION_AUTHORIZATION_TYPE：特约商户信息授权类型；
2. FUND_AUTHORIZATION_TYPE：特约商户资金授权类型；
3. INFORMATION_AND_FUND_AUTHORIZATION_TYPE：特约商户信息和资金授权类型。
批量转账一旦发起后，不允许撤销，批次受理成功后开始执行转账。
当返回错误时，请不要更换商家批次单号，一定要使用原商家批次单号重试，否则可能造成重复转账等资金风险。
因调用方自身系统设置存在问题导致的资金损失，由调用方自行承担。
请服务商在自身的系统中合理设置转账频次并做好并发控制，防范错付风险。
转账额度限制请看下面的说明。

请求接口

openapi/pay/fund/wxSpTransferBatch

公共参数

请求参数

参数	必填	类型	说明
sub_mchid	是	String(64)	微信支付特约商户号
sub_appid	否	String(32)	特约商户授权类型为“资金授权”或“资金与信息授权”时需要填写
out_batch_no	是	String(32)	商家批次单号
batch_name	是	String(32)	批次名称
batch_remark	是	String(32)	批次备注
total_amount	是	int	转账总金额，单位：分
total_num	是	int	转账总笔数。一个转账批次单最多发起三千笔转账。转账总笔数必须与批次内所有明细之和保持一致，否则无法发起转账操作。
transfer_detail_list	是	array	转账明细列表。发起批量转账的明细列表，最多三千笔。
transfer_purpose	否	String(32)	批量转账用途。枚举： GOODSPAYMENT：货款 COMMISSION：佣金 REFUND：退款 REIMBURSEMENT：报销 FREIGHT：运费 OTHERS：其他

transfer_detail_list列表参数

参数	必填	类型	说明
out_detail_no	是	String(32)	商家明细单号
transfer_amount	是	int	转账金额，单位：分
transfer_remark	是	String(32)	转账备注
openid	是	String(64)	收款用户openid。如果转账特约商户授权类型是“信息授权”，对应的是特约商户公众号下的openid。 “资金授权”或“资金与信息授权”对应的是服务商公众号下的openid。
user_name	是	String(32)	收款用户姓名
user_id_card	否	String(32)	收款用户身份证

content请求示例

{
  "sub_mchid": "1900000109",
  "sub_appid": "wxf636efh567hg4356",
  "out_batch_no": "plfk20210611132926",
  "batch_name": "2021年6月报销单",
  "batch_remark": "2021年6月报销单",
  "total_amount": 200000,
  "total_num": 2,
  "transfer_detail_list": [
    {
      "out_detail_no": "plfk2021061113292601",
      "transfer_amount": 120000,
      "transfer_remark": "6月报销",
      "openid": "o-MYE42l80oelYMDE34nYD456Xoy",
      "user_name": "张三",
      "user_id_card": "440106200101019856"
    },
    {
      "out_detail_no": "plfk20210611132922",
      "transfer_amount": 80000,
      "transfer_remark": "6月报销",
      "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": "plfk2020042013",
  "batch_id": "1030000071100999991182020050700019480001",
  "create_time": "2021-06-11 13:29:35"
}

转账额度说明

额度	默认最小	默认最大	可调上限	线下特殊申请提额
单商户单日转出额度	0	100,000	1,000,000	支持
单笔转账额度	1	5,000	20,000	支持
单日用户收款额度	0	5,000	20,000	支持
单月用户收款额度	0	100,000	200,000	支持
单日用户收款次数	1	10	-	支持

::: warning 注意

额度如需调整需联系服务商配置，有一定的使用流水支撑才可调整通过。即全新或未使用过转账功能的特约商户号，一般不可调整额度。
使用的额度超过当前额度的80%时，可申请提升。
单笔转账额度最低可调整到0.30元。
给同一个实名用户付款，单笔/单日限额5千元/5千元，可根据使用情况逐步提升到2万元。
以上规则中的限额5000、10万由于微信侧计算规则与风控策略的关系，不是完全精确值，金额仅做参考，请不要依赖此金额做系统处理，应以接口实际返回和查询结果为准。 :::

错误描述说明

公共返回码

错误描述	解决方案
系统错误	请勿更换商家转账批次单号，请使用相同参数再次调用API。否则可能造成资金损失
参数错误	根据错误提示，传入正确参数
商户信息不合法	登录商户平台核对，传入正确信息
请求参数符合参数格式，但不符合业务规则	根据错误提示，传入正确参数
商户号和appid没有绑定关系	商户号和appid没有绑定关系
资金不足	商户账户资金不足，请充值后原单重试，请勿更换商家转账批次单号
超出商户单日转账额度	超出商户单日转账额度，请核实产品设置是否准确
频率超限	该笔请求未受理，请降低频率后原单重试，请勿更换商家转账批次单号
此IP地址不允许调用该接口	联系服务商添加授权的IP白名单
超过用户单笔收款额度	检查单笔转账金额是否超过配置的金额上下限，一般情况最少0.3元

请求接口​

公共参数​

请求参数​

transfer_detail_list列表参数​

响应参数​

响应示例​

转账额度说明​

错误描述说明​

请求接口

公共参数

请求参数

transfer_detail_list列表参数

响应参数

响应示例

转账额度说明

错误描述说明