最新更新時(shí)間：2022.04.24 版本說明
商戶可以通過該接口同時(shí)向多個(gè)用戶微信零錢進(jìn)行轉(zhuǎn)賬操作。
? 商戶上送敏感信息時(shí)使用微信支付平臺(tái)公鑰加密，證書序列號(hào)包含在請(qǐng)求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則。
? 批量轉(zhuǎn)賬一旦發(fā)起后，不允許撤銷，批次受理成功后開始執(zhí)行轉(zhuǎn)賬。
? 轉(zhuǎn)賬批次單中涉及金額的字段單位為“分”。
? 當(dāng)返回錯(cuò)誤碼為“SYSTEM_ERROR”時(shí)，請(qǐng)不要更換商家批次單號(hào)，一定要使用原商家批次單號(hào)重試，否則可能造成重復(fù)轉(zhuǎn)賬等資金風(fēng)險(xiǎn)。
? 微信支付視任何不同“商家批次單號(hào)（out_batch_no）”的請(qǐng)求為一個(gè)全新的批次。在未查詢到明確的轉(zhuǎn)賬批次單處理結(jié)果之前，請(qǐng)勿修改商家批次單號(hào)重新提交！如有發(fā)生，商戶應(yīng)當(dāng)自行承擔(dān)因此產(chǎn)生的所有損失和責(zé)任。
? 請(qǐng)商戶在自身的系統(tǒng)中合理設(shè)置轉(zhuǎn)賬頻次并做好并發(fā)控制，防范錯(cuò)付風(fēng)險(xiǎn)。
? 因商戶自身系統(tǒng)設(shè)置存在問題導(dǎo)致的資金損失，由商戶自行承擔(dān)。
適用對(duì)象：直連商戶
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/transfer/batches
請(qǐng)求方式：POST
接口限頻： 單個(gè)商戶 50QPS，如果超過頻率限制，會(huì)報(bào)錯(cuò)FREQUENCY_LIMITED，請(qǐng)降低頻率請(qǐng)求。
是否需要證書：是
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 直連商戶的appid | appid | string[1,32] | 是 | body申請(qǐng)商戶號(hào)的appid或商戶號(hào)綁定的appid（企業(yè)號(hào)corpid即為此appid） 示例值：wxf636efh567hg4356 |
| 商家批次單號(hào) | out_batch_no | string[1,32] | 是 | body商戶系統(tǒng)內(nèi)部的商家批次單號(hào)，要求此參數(shù)只能由數(shù)字、大小寫字母組成，在商戶系統(tǒng)內(nèi)部唯一 示例值：plfk2020042013 |
| 批次名稱 | batch_name | string[1,32] | 是 | body該筆批量轉(zhuǎn)賬的名稱 示例值：2019年1月深圳分部報(bào)銷單 |
| 批次備注 | batch_remark | string[1,32] | 是 | body轉(zhuǎn)賬說明，UTF8編碼，最多允許32個(gè)字符 示例值：2019年1月深圳分部報(bào)銷單 |
| 轉(zhuǎn)賬總金額 | total_amount | int | 是 | body轉(zhuǎn)賬金額單位為“分”。轉(zhuǎn)賬總金額必須與批次內(nèi)所有明細(xì)轉(zhuǎn)賬金額之和保持一致，否則無法發(fā)起轉(zhuǎn)賬操作 示例值：4000000 |
| 轉(zhuǎn)賬總筆數(shù) | total_num | int | 是 | body一個(gè)轉(zhuǎn)賬批次單最多發(fā)起三千筆轉(zhuǎn)賬。轉(zhuǎn)賬總筆數(shù)必須與批次內(nèi)所有明細(xì)之和保持一致，否則無法發(fā)起轉(zhuǎn)賬操作 示例值：200 |
| +轉(zhuǎn)賬明細(xì)列表 | transfer_detail_list | array | 是 | body發(fā)起批量轉(zhuǎn)賬的明細(xì)列表，最多三千筆 |
| 轉(zhuǎn)賬場景ID | transfer_scene_id | string[4, 10] | 否 | 該批次轉(zhuǎn)賬使用的轉(zhuǎn)賬場景，可在「商家轉(zhuǎn)賬到零錢 - 產(chǎn)品設(shè)置」中查看詳情，如不填寫則使用商家的默認(rèn)轉(zhuǎn)賬場景 如：1001 - 現(xiàn)金營銷 示例值：1001 |
{
"appid": "wxf636efh567hg4356",
"out_batch_no": "plfk2020042013",
"batch_name": "2019年1月深圳分部報(bào)銷單",
"batch_remark": "2019年1月深圳分部報(bào)銷單",
"total_amount": 4000000,
"total_num": 200,
"transfer_detail_list": [
{
"out_detail_no": "x23zy545Bd5436",
"transfer_amount": 200000,
"transfer_remark": "2020年4月報(bào)銷",
"openid": "o-MYE42l80oelYMDE34nYD456Xoy",
"user_name": "757b340b45ebef5467rter35gf464344v3542sdf4t6re4tb4f54ty45t4yyry45"
}
]
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商家批次單號(hào) | out_batch_no | string[1,32] | 是 | 商戶系統(tǒng)內(nèi)部的商家批次單號(hào) 示例值：plfk2020042013 |
| 微信批次單號(hào) | batch_id | string[1,64] | 是 | 微信批次單號(hào)，微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識(shí) 示例值：1030000071100999991182020050700019480001 |
| 批次創(chuàng)建時(shí)間 | create_time | string[1,32] | 是 | 批次受理成功時(shí)返回，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss.sss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35.120+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒 示例值：2015-05-20T13:29:35.120+08:00 |
{
"out_batch_no": "plfk2020042013",
"batch_id": "1030000071100999991182020050700019480001",
"create_time": "2015-05-20T13:29:35.120+08:00"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 請(qǐng)勿更換商家轉(zhuǎn)賬批次單號(hào)，請(qǐng)使用相同參數(shù)再次調(diào)用API。否則可能造成資金損失 |
| 401 | APPID_MCHID_NOT_MATCH | 商戶號(hào)和appid沒有綁定關(guān)系 | 商戶號(hào)和appid沒有綁定關(guān)系 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 根據(jù)錯(cuò)誤提示，傳入正確參數(shù) |
| INVALID_REQUEST | 請(qǐng)求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 | 根據(jù)錯(cuò)誤提示，傳入正確參數(shù) | |
| 403 | NO_AUTH | 商戶信息不合法 | 登錄商戶平臺(tái)核對(duì)，傳入正確信息 |
| NOT_ENOUGH | 資金不足 | 商戶賬戶資金不足，請(qǐng)充值后原單重試，請(qǐng)勿更換商家轉(zhuǎn)賬批次單號(hào) | |
| ACCOUNTERROR | 商戶賬戶付款受限 | 可前往商戶平臺(tái)-違約記錄獲取解除功能限制指引 | |
| 429 | QUOTA_EXCEED | 超出商戶單日轉(zhuǎn)賬額度 | 超出商戶單日轉(zhuǎn)賬額度，請(qǐng)核實(shí)產(chǎn)品設(shè)置是否準(zhǔn)確 |
| FREQUENCY_LIMITED | 頻率超限 | 該筆請(qǐng)求未受理，請(qǐng)降低頻率后原單重試，請(qǐng)勿更換商家轉(zhuǎn)賬批次單號(hào) |