刪除分賬接收方
應(yīng)用場景
服務(wù)商代子商戶發(fā)起刪除分賬接收方請求,刪除后不支持將結(jié)算后的錢分到該分賬接收方。
接口說明
請求Url | https://api.mch.weixin.qq.com/pay/profitsharingremovereceiver |
---|---|
是否需要證書 | 否 |
請求方式 | post |
簽名方式 | HMAC-SHA256 |
請求參數(shù)
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
微信支付分配的服務(wù)商商戶號 |
子商戶號 |
sub_mch_id |
二選一 | string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
品牌主商戶號 |
brand_mch_id |
string(32) |
1900000109 |
當(dāng)開通了“連鎖品牌工具”后,使用品牌供應(yīng)鏈分賬時,分賬接收方需配置在品牌主維度。子商戶號和品牌主商戶號二選一填寫。 |
|
公眾賬號ID |
appid |
是 |
string(32) |
wx8888888888888888 |
微信分配的服務(wù)商appid |
子商戶公眾賬號ID |
sub_appid |
否 |
string(32) |
wx8888888888888888 |
微信分配的子商戶公眾賬號ID |
隨機字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機字符串,不長于32位。推薦隨機數(shù)生成算法 |
簽名 |
sign |
是 |
string(64) |
ABC6DD4AA85C0EECA82C35595A69EFGH |
簽名,詳見簽名生成算法 |
簽名類型 |
sign_type |
否 |
string(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |
+分賬接收方 | receiver |
是 |
String(2048) |
內(nèi)容見下方示例 | 分賬接收方對象,json格式 點擊行前的+展開字段詳情 |
舉例如下:
<xml>
<mch_id>10000100</mch_id>
??
<sub_mch_id>1415701182</sub_mch_id>
<appid>wx2421b1c4370ec43b</appid>
??
<sub_appid>wx2203b1494370e08cm</sub_appid>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<sign>ABC6DD4AA85C0EECA82C35595A69EFGH</sign>
<sign_type>HMAC-SHA256</sign_type>
<receiver>
{
??????
"type": "MERCHANT_ID",
??????
"account": "190001001",
??????
"name": "示例商戶全稱"
}
</receiver>
</xml>
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
string(32) |
SUCCESS |
SUCCESS/FAIL 此字段是通信標識,非交易標識 |
返回信息 |
return_msg |
否 |
string(256) |
參數(shù)格式校驗錯誤 |
返回信息,如非空,為錯誤原因 |
以下字段在return_code為SUCCESS的時候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
string(32) |
SUCCESS |
SUCCESS:刪除分賬接收方成功 |
錯誤代碼 |
err_code |
否 |
string(32) |
SYSTEMERROR |
列表詳見錯誤碼列表 |
錯誤代碼描述 |
err_code_des |
否 |
String(128) |
系統(tǒng)超時 |
結(jié)果信息描述 |
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
調(diào)用接口時提供的商戶號 |
子商戶號 |
sub_mch_id |
是 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
公眾賬號ID |
appid |
是 |
string(32) |
wx8888888888888888 |
調(diào)用接口提供的公眾賬號ID |
子商戶公眾賬號ID |
sub_appid |
否 |
string(32) |
wx8888888888888888 |
微信分配的子商戶公眾賬號ID |
分賬接收方 |
receiver |
是 |
String(2048) |
{"type":"MERCHANT_ID","account":"190001001"?} |
分賬接收方對象(不包含分賬接收方全稱),json格式 |
隨機字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
微信返回的隨機字符串 |
簽名 |
sign |
是 |
string(64) |
ABC6DD4AA85C0EECA82C35595A69EFGH |
微信返回的簽名,詳見簽名算法 |
錯誤碼列表
名稱 |
描述 |
原因 |
解決方案 |
---|---|---|---|
SYSTEMERROR |
接口返回錯誤 |
系統(tǒng)超時 |
請使用相同參數(shù)再次調(diào)用API |
PARAM_ERROR |
參數(shù)錯誤 |
請求參數(shù)未按指引進行填寫 |
請求參數(shù)錯誤,請重新檢查再調(diào)用API |
INVALID_REQUEST |
請求不合法 |
參數(shù)中APPID或 MCHID不存在等 |
請檢查請求參數(shù) |
OPENID_MISMATCH |
Openid錯誤 |
Openid 與Appid不匹配 |
請檢查Openid 是否正確 |
FREQUENCY_LIMITED |
頻率限制 |
請求過多被頻率限制 |
該筆請求未受理,請降低頻率后原單重試 |
NOAUTH |
無分賬權(quán)限 |
未開通分賬權(quán)限 |
請先開通分賬 |
USER_NOT_EXIST |
分賬接收方不存在 |
分賬接收方不存在 |
請確認分賬接收方類型或者賬號無誤后重試 |