發(fā)起商家轉(zhuǎn)賬接口。商戶可以通過該接口同時向多個用戶微信零錢進(jìn)行轉(zhuǎn)賬操作。請求消息中應(yīng)包含商家批次單號、轉(zhuǎn)賬名稱、appid、轉(zhuǎn)賬總金額、轉(zhuǎn)賬總筆數(shù)、轉(zhuǎn)賬openid、收款用戶姓名等信息。注意受理成功將返回批次單號,此時并不代表轉(zhuǎn)賬成功,請通過查單接口查詢單據(jù)的付款狀態(tài)
# 接口說明
支持商戶:
【普通商戶】
請求方式:
【POST】/v3/transfer/batches
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
Header HTTP頭參數(shù)
- appid 必填 string(32)【商戶appid】 申請商戶號的appid或商戶號綁定的appid(企業(yè)號corpid即為此appid)
- out_batch_no 必填 string(32)【商家批次單號】 商戶系統(tǒng)內(nèi)部的商家批次單號,要求此參數(shù)只能由數(shù)字、大小寫字母組成,在商戶系統(tǒng)內(nèi)部唯一
- batch_name 必填 string(32)【批次名稱】 該筆批量轉(zhuǎn)賬的名稱
- batch_remark 必填 string(32)【批次備注】 轉(zhuǎn)賬說明,UTF8編碼,最多允許32個字符
- total_amount 必填 integer【轉(zhuǎn)賬總金額】 轉(zhuǎn)賬金額單位為“分”。轉(zhuǎn)賬總金額必須與批次內(nèi)所有明細(xì)轉(zhuǎn)賬金額之和保持一致,否則無法發(fā)起轉(zhuǎn)賬操作
- total_num 必填 integer【轉(zhuǎn)賬總筆數(shù)】 一個轉(zhuǎn)賬批次單最多發(fā)起一千筆轉(zhuǎn)賬。轉(zhuǎn)賬總筆數(shù)必須與批次內(nèi)所有明細(xì)之和保持一致,否則無法發(fā)起轉(zhuǎn)賬操作
- transfer_detail_list 必填 array[TransferDetailInput]【轉(zhuǎn)賬明細(xì)列表】 發(fā)起批量轉(zhuǎn)賬的明細(xì)列表,最多一千筆
- 屬性
- transfer_scene_id 選填 string(36)【轉(zhuǎn)賬場景ID】 該批次轉(zhuǎn)賬使用的轉(zhuǎn)賬場景,如不填寫則使用商家的默認(rèn)場景,如無默認(rèn)場景可為空,可前往“商家轉(zhuǎn)賬到零錢-前往功能”中申請。
如:1001-現(xiàn)金營銷 - notify_url 選填 string(256)【通知地址】 異步接收微信支付結(jié)果通知的回調(diào)地址,通知url必須為公網(wǎng)可訪問的url,必須為https,不能攜帶參數(shù)。
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- out_batch_no 必填 string(32)【商家批次單號】 商戶系統(tǒng)內(nèi)部的商家批次單號,在商戶系統(tǒng)內(nèi)部唯一
- batch_id 必填 string(64)【微信批次單號】 微信批次單號,微信商家轉(zhuǎn)賬系統(tǒng)返回的唯一標(biāo)識
- create_time 必填 string(32)【批次創(chuàng)建時間】 批次受理成功時返回,按照使用rfc3339所定義的格式,格式為YYYY-MM-DDThh:mm:ss+TIMEZONE
- batch_status 選填 string【批次狀態(tài)】 ACCEPTED:已受理。批次已受理成功,若發(fā)起批量轉(zhuǎn)賬的30分鐘后,轉(zhuǎn)賬批次單仍處于該狀態(tài),可能原因是商戶賬戶余額不足等。商戶可查詢賬戶資金流水,若該筆轉(zhuǎn)賬批次單的扣款已經(jīng)發(fā)生,則表示批次已經(jīng)進(jìn)入轉(zhuǎn)賬中,請再次查單確認(rèn)
PROCESSING:轉(zhuǎn)賬中。已開始處理批次內(nèi)的轉(zhuǎn)賬明細(xì)單
FINISHED:已完成。批次內(nèi)的所有轉(zhuǎn)賬明細(xì)單都已處理完成
CLOSED:已關(guān)閉。可查詢具體的批次關(guān)閉原因確認(rèn)
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 請求參數(shù)符合參數(shù)格式,但不符合業(yè)務(wù)規(guī)則 | 根據(jù)錯誤提示,傳入正確參數(shù) |
400 | INVALID_REQUEST | 創(chuàng)建訂單沖突,請勿并發(fā)調(diào)用 | 根據(jù)錯誤提示調(diào)整調(diào)用策略 |
400 | INVALID_REQUEST | 對應(yīng)單號已超出重試期,請查單確認(rèn)后決定是否換單請求 | 根據(jù)錯誤提示調(diào)整調(diào)用策略 |
400 | INVALID_REQUEST | 此IP地址不允許調(diào)用該接口 | 請在商戶平臺-商家轉(zhuǎn)賬產(chǎn)品詳情-轉(zhuǎn)賬發(fā)起方式-API發(fā)起-接口安全 中配置發(fā)起轉(zhuǎn)賬的IP地址 |
400 | INVALID_REQUEST | API通道未開啟 | 請在商戶平臺-商家轉(zhuǎn)賬產(chǎn)品設(shè)置中配置API發(fā)起轉(zhuǎn)賬 |
400 | INVALID_REQUEST | 產(chǎn)品權(quán)限異常 | 請在商戶平臺-商家轉(zhuǎn)賬產(chǎn)品設(shè)置中開通產(chǎn)品權(quán)限 |
400 | INVALID_REQUEST | 超出商戶單日轉(zhuǎn)賬額度,請核實產(chǎn)品設(shè)置是否準(zhǔn)確 | 請在商戶平臺-商家轉(zhuǎn)賬產(chǎn)品設(shè)置中配置轉(zhuǎn)賬日限額 |
400 | INVALID_REQUEST | 你尚未獲取該轉(zhuǎn)賬場景 | 請在商戶平臺-商家轉(zhuǎn)賬產(chǎn)品設(shè)置中申請該場景 |
400 | INVALID_REQUEST | 未配置收款用戶列表 | 請前往商戶平臺-商家轉(zhuǎn)賬到零錢-轉(zhuǎn)賬場景中添加 |
400 | PARAM_ERROR | 單批次明細(xì)筆數(shù)不合法,最高支持1000筆明細(xì)用 | 根據(jù)錯誤提示調(diào)整策略 |
401 | APPID_MCHID_NOT_MATCH | 商戶號和AppID沒有綁定關(guān)系 | 商戶號和AppID沒有綁定關(guān)系 |
403 | ACCOUNTERROR | 商戶賬戶付款受限 | 可前往商戶平臺-違約記錄獲取解除功能限制指引 |
403 | NO_AUTH | 商戶信息不合法 | 登錄商戶平臺核對,傳入正確信息 |
403 | NOT_ENOUGH | 資金不足 | 商戶賬戶資金不足,請充值后原單重試,請勿更換商家轉(zhuǎn)賬批次單號 |
429 | FREQUENCY_LIMITED | 頻率超限 | 該筆請求未受理,請降低頻率后原單重試,請勿更換商家轉(zhuǎn)賬批次單號 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請勿更換商家轉(zhuǎn)賬批次單號,請使用相同參數(shù)再次調(diào)用API。否則可能造成資金損失 |