- 電商平臺可通過此接口添加分賬接收方,建立分賬接收方列表。后續(xù)通過發(fā)起分賬請求,將電商平臺下的二級商戶結算后的資金,分給分賬接收方列表中具體的分賬接收方。
- 添加的分賬接收方統(tǒng)一都在電商平臺維度進行管理,其他二級商戶,均可向該分賬接收方列表中的接收方進行分賬,避免在二級商戶維度重復維護。
- 最多可添加20000個分賬接收方
- 電商平臺需確保向微信支付傳輸用戶身份信息和賬號標識信息做一致性校驗已合法征得用戶授權。
# 接口說明
支持商戶:
【平臺商戶】
請求方式:
【POST】/v3/ecommerce/profitsharing/receivers/add
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json
- Content-Type 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- appid 選填 string(32)【公眾賬號ID】 微信分配的公眾賬號ID
- type 必填 string(32)【接收方類型】 分賬接收方的類型,枚舉值:
MERCHANT_ID:商戶
PERSONAL_OPENID:個人 - account 必填 string(64)【接收方賬號】 分賬接收方的賬號
類型是MERCHANT_ID時,是商戶號
類型是PERSONAL_OPENID時,是個人openid - name 選填 string(256)【接收方名稱】 商戶全稱。僅接收方類型是MERCHANT_ID時,才需要填寫此字段。
- relation_type 必填 string(32)【與分賬方的關系類型】 子商戶與接收方的關系。 本字段值為枚舉: SUPPLIER:供應商 DISTRIBUTOR:分銷商 SERVICE_PROVIDER:服務商 PLATFORM:平臺 OTHERS:其他
Body 包體參數(shù)
請求示例
POST
# 應答參數(shù)
- type 必填 string【接收方類型】 分賬接收方的類型,枚舉值:
MERCHANT_ID:商戶
PERSONAL_OPENID:個人 - account 必填 string【接收方賬號】 分賬接收方的賬號
類型是MERCHANT_ID時,是商戶號
類型是PERSONAL_OPENID時,是個人openid
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入參數(shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 無效請求 | 請確認分賬接收方是否存在 |
400 | PARAM_ERROR | 請求參數(shù)不符合參數(shù)格式 | 請使用正確的參數(shù)重新調用 |
403 | NO_AUTH | 商戶無權限 | 請開通商戶號分賬權限 |
429 | FREQUENCY_LIMITED | 添加接收方頻率過高 | 請降低頻率后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調用 |