服務商發(fā)起刪除分賬接收方請求。刪除后,不再支持品牌主或門店分到該分賬接收方。
# 接口說明
支持商戶:
【普通服務商】
請求方式:
【POST】/v3/brand/profitsharing/receivers/delete
請求域名:
【主域名】
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ù)
- brand_mchid 必填 string(32)【品牌主商戶號】 品牌主商戶號,即綁定具體品牌的商戶號,填寫微信支付分配的商戶號
- appid 必填 string(32)【公眾賬號ID】 微信分配的公眾賬號ID
- sub_appid 選填 string(32)【子商戶公眾賬號ID】 品牌主的公眾賬號ID,分賬接收方類型包含PERSONAL_SUB_OPENID時必填
- type 必填 string(32)【接收方類型】 分賬接收方類型,枚舉值:
1. MERCHANT_ID:商戶號(mch_id或者sub_mch_id)
2. PERSONAL_OPENID:個人OpenID(由服務商的AppID轉換得到)
3. PERSONAL_SUB_OPENID:個人OpenID(由品牌主的AppID轉換得到) - account 必填 string(64)【接收方賬號】 分賬接收方賬號
1. 分賬接收方類型為MERCHANT_ID時,分賬接收方賬號為商戶號(mch_id或者sub_mch_id)
2. 分賬接收方類型為PERSONAL_OPENID時,分賬接收方賬號為個人OpenID(由服務商的AppID轉換得到)
3. 分賬接收方類型為PERSONAL_SUB_OPENID時,分賬接收方賬號為個人OpenID(由品牌主的AppID轉換得到)
Body 包體參數(shù)
請求示例
POST
# 應答參數(shù)
- brand_mchid 必填 string(32)【品牌主商戶號】 品牌主商戶號,即綁定具體品牌的商戶號,填寫微信支付分配的商戶號。
- type 必填 string(32)【接收方類型】 分賬接收方類型,枚舉值:
1. MERCHANT_ID:商戶ID
2. PERSONAL_OPENID:個人OpenID(由父商戶AppID轉換得到)
3. PERSONAL_SUB_OPENID:個人OpenID(由品牌主的AppID轉換得到) - account 必填 string(64)【接收方賬號】 分賬接收方賬號
1. 分賬接收方類型為MERCHANT_ID時,分賬接收方賬號為商戶號(mch_id或者sub_mch_id)
2. 分賬接收方類型為PERSONAL_OPENID時,分賬接收方賬號為個人OpenID(由服務商的AppID轉換得到)
3. 分賬接收方類型為PERSONAL_SUB_OPENID時,分賬接收方賬號為個人OpenID(由品牌主的AppID轉換得到)
200OK
應答示例
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è)務錯誤碼
狀態(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ù)稍后重新調用 |