发起批量转账

服务商可以通过该接口，批量向用户零钱进行转账操作。

请求参数	类型	描述
json	object	声明请求的`JSON`数据结构
sub_mchid	string	特约商户号
sub_appid	string	特约商户appid
authorization_type	string	特约商户授权类型 `INFORMATION_AUTHORIZATION_TYPE` \| `FUND_AUTHORIZATION_TYPE` \| `INFORMATION_AND_FUND_AUTHORIZATION_TYPE` 枚举值之一
out_batch_no	string	商家批次单号
batch_name	string	批次名称
batch_remark	string	批次备注
total_amount	integer	转账总金额
total_num	integer	转账总笔数
transfer_detail_list	object[]	转账明细列表
out_detail_no	string	商家明细单号
transfer_amount	integer	转账金额
transfer_remark	string	转账备注
openid	string	收款用户openid
user_name	string	收款用户姓名
user_id_card	string	收款用户身份证
sp_appid	string	服务商的appid
transfer_purpose	string	批量转账用途 `GOODSPAYMENT` \| `COMMISSION` \| `REFUND` \| `REIMBURSEMENT` \| `FREIGHT` \| `OTHERS` 枚举值之一
transfer_scene	string	转账场景 `ORDINARY_TRANSFER` \| `PAYROLL_CARD_TRANSFER` 枚举值之一
headers	object	声明请求的头参数
Wechatpay-Serial	string	平台公钥ID/平台公钥证书序列号

php

$instance->v3->partnerTransfer->batches->postAsync([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/partner-transfer/batches')->postAsync([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/partner-transfer/batches']->postAsync([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->partnerTransfer->batches->post([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/partner-transfer/batches')->post([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/partner-transfer/batches']->post([
  'json' => [
    'sub_mchid' => '1900000109',
    'sub_appid' => 'wxf636efh567hg4356',
    'authorization_type' => 'INFORMATION_AUTHORIZATION_TYPE',
    'out_batch_no' => 'plfk2020042013',
    'batch_name' => '2019年1月深圳分部报销单',
    'batch_remark' => '2019年1月深圳分部报销单',
    'total_amount' => 4000000,
    'total_num' => 200,
    'transfer_detail_list' => [[
      'out_detail_no' => 'x23zy545Bd5436',
      'transfer_amount' => 200000,
      'transfer_remark' => '2020年4月报销',
      'openid' => 'o-MYE42l80oelYMDE34nYD456Xoy',
      'user_name' => '757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45',
      'user_id_card' => '8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f',
    ],],
    'sp_appid' => 'wxf636efh567hg4388',
    'transfer_purpose' => 'COMMISSION',
    'transfer_scene' => 'ORDINARY_TRANSFER',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
out_batch_no	string	商家批次单号
batch_id	string	微信支付批次单号
create_time	string	批次创建时间

参阅官方文档官方文档

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

免确认

免确认

直连商户模式

合作伙伴模式

可用版本

可用版本

可用版本

发起批量转账 ​

发起批量转账