添加分賬接收方
應用場景
商戶發(fā)起添加分賬接收方請求，后續(xù)可通過發(fā)起分賬請求將結(jié)算后的錢分到該分賬接收方。
注意：
? 商戶需確保向微信支付傳輸用戶身份信息和賬號標識信息做一致性校驗已合法征得用戶授權
接口說明
| 請求Url | https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver |
|---|---|
| 是否需要證書 | 否 |
| 請求方式 | post |
| 簽名方式 | HMAC-SHA256 |
請求參數(shù)
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
|---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
微信支付分配的商戶號 |
公眾賬號ID |
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>
<appid>wx2421b1c4370ec43b</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>
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
|---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
string(32) |
SUCCESS |
SUCCESS/FAIL 此字段是通信標識，非交易標識 |
返回信息 |
return_msg |
否 |
string(256) |
參數(shù)格式校驗錯誤 |
返回信息，如非空，為錯誤原因 |
以下字段在return_code為SUCCESS的時候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
|---|---|---|---|---|---|
業(yè)務結(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)用接口時提供的商戶號 |
公眾賬號ID |
appid |
是 |
string(32) |
wx8888888888888888 |
調(diào)用接口提供的公眾賬號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 |
無分賬權限 |
未開通分賬權限 |
請先開通分賬 |
USER_NOT_EXIST |
分賬接收方不存在 |
分賬接收方不存在 |
請確認分賬接收方類型或者賬號無誤后重試 |
ACCOUNTERROR |
分賬接收方賬戶不存在 |
賬戶未開通 |
賬戶未開通，請接收方商戶在商戶平臺點擊“充值”創(chuàng)建賬戶 |