添加分賬接收方
應用場景
服務商代子商戶發(fā)起添加分賬接收方請求,后續(xù)可通過發(fā)起分賬請求將結算后的錢分到該分賬接收方。
注意:
? 服務商需確保向微信支付傳輸用戶身份信息和賬號標識信息做一致性校驗已合法征得用戶授權
接口說明
請求Url | https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver |
---|---|
是否需要證書 | 否 |
請求方式 | post |
簽名方式 | HMAC-SHA256 |
請求參數
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
微信支付分配的服務商商戶號 |
子商戶號 |
sub_mch_id |
二選一 | string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
品牌主商戶號 |
brand_mch_id |
string(32) |
1900000109 |
當開通了“連鎖品牌工具”后,使用品牌供應鏈分賬時,分賬接收方需配置在品牌主維度。子商戶號和品牌主商戶號二選一填寫。 |
|
公眾賬號ID |
appid |
是 |
string(32) |
wx8888888888888888 |
微信分配的服務商appid |
子商戶公眾賬號ID |
sub_appid |
否 |
string(32) |
wx8888888888888888 |
微信分配的子商戶公眾賬號ID |
隨機字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機字符串,不長于32位。推薦隨機數生成算法 |
簽名 |
sign |
是 |
string(64) |
ABC6DD4AA85C0EECA82C35595A69EFGH |
簽名,詳見簽名生成算法 |
簽名類型 |
sign_type |
否 |
string(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |
+分賬接收方 | receiver |
是 |
String(2048) |
內容見下方示例 | 分賬接收方對象,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": "示例商戶全稱",
"relation_type": "STORE_OWNER"
}
</receiver>
</xml>
返回結果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
string(32) |
SUCCESS |
SUCCESS/FAIL 此字段是通信標識,非交易標識 |
返回信息 |
return_msg |
否 |
string(256) |
參數格式校驗錯誤 |
返回信息,如非空,為錯誤原因 |
以下字段在return_code為SUCCESS的時候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務結果 |
result_code |
是 |
string(32) |
SUCCESS |
SUCCESS:添加分賬接收方成功 |
錯誤代碼 |
err_code |
否 |
string(32) |
SYSTEMERROR |
列表詳見錯誤碼列表 |
錯誤代碼描述 |
err_code_des |
否 |
String(128) |
系統(tǒng)超時 |
結果信息描述 |
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
調用接口時提供的商戶號 |
子商戶號 |
sub_mch_id |
是 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
公眾賬號ID |
appid |
是 |
string(32) |
wx8888888888888888 |
調用接口提供的公眾賬號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)超時 |
請使用相同參數再次調用API |
PARAM_ERROR |
參數錯誤 |
請求參數未按指引進行填寫 |
請求參數錯誤,請重新檢查再調用API |
INVALID_REQUEST |
請求不合法 |
參數中APPID或 MCHID不存在等 |
請檢查請求參數 |
OPENID_MISMATCH |
Openid錯誤 |
Openid 與Appid不匹配 |
請檢查Openid 是否正確 |
FREQUENCY_LIMITED |
頻率限制 |
請求過多被頻率限制 |
該筆請求未受理,請降低頻率后原單重試 |
NOAUTH |
無分賬權限 |
未開通分賬權限 |
請先開通分賬 |
USER_NOT_EXIST |
分賬接收方不存在 |
分賬接收方不存在 |
請確認分賬接收方類型或者賬號無誤后重試 |
ACCOUNTERROR |
分賬接收方賬戶不存在 |
賬戶未開通 |
賬戶未開通,請接收方商戶在商戶平臺點擊“充值”創(chuàng)建賬戶 |