查詢最大分賬比例API
應(yīng)用場景
服務(wù)商可以查詢子商戶設(shè)置的允許服務(wù)商分賬的最大比例。
接口頻率:30QPS
接口說明
請求Url | https://api.mch.weixin.qq.com/pay/profitsharingmerchantratioquery |
---|---|
是否需要證書 | 否 |
請求方式 | post |
簽名方式 | HMAC-SHA256 |
請求參數(shù)
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
微信支付分配的服務(wù)商戶號 |
子商戶號 |
sub_mch_id |
二選一傳入 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。普通分賬傳入子商戶號時,查詢子商戶號的設(shè)置的最大分賬比例。 |
品牌主商戶號 |
brand_mch_id |
string(32) |
1900000108 |
當(dāng)服務(wù)商開通了“連鎖品牌工具”后,使用品牌供應(yīng)鏈分賬時,傳入品牌主商戶號,查詢品牌主設(shè)置的全局分賬比例,品牌主下的門店適用于此比例。 |
|
隨機字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機字符串,不長于32位。推薦隨機數(shù)生成算法 |
簽名 |
sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6C380BEC2BFD727A4B6845133519F3AD6 |
簽名,詳見簽名生成算法 |
簽名類型 |
sign_type |
否 |
string(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |
舉例如下:
<xml>
<mch_id>10000100</mch_id>
<sub_mch_id>10000101</sub_mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<sign_type>HMAC-SHA256</sign_type>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
</xml>
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
string(32) |
SUCCESS |
枚舉值: SUCCESS:分賬回退處理成功 FAIL:分賬回退處理失敗 |
錯誤代碼 |
err_code |
否 |
string(32) |
SYSTEMERROR |
如果返回狀態(tài)碼為FAIL,則本字段存在,且為失敗的錯誤碼 詳見錯誤碼列表 |
返回信息 |
err_msg |
否 |
string(256) |
參數(shù)格式校驗錯誤 |
如果返回狀態(tài)碼為FAIL,則本字段存在,且為失敗的錯誤信息 |
以下字段在return_code為SUCCESS的時候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
調(diào)用接口時提供的服務(wù)商戶號。 |
子商戶號 |
sub_mch_id |
否 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。查詢子商戶號的設(shè)置的最大分賬比例(普通分賬)時返回此字段。 |
品牌主商戶號 |
brand_mch_id |
否 |
string(32) |
1900000108 |
調(diào)用接口時提供的品牌主商戶號。查詢品牌主商戶設(shè)置的全局分賬比例(品牌分賬)時返回此字段。 |
最大分賬比例 |
max_ratio |
是 |
int |
2000 |
子商戶允許服務(wù)商分賬的最大比例,單位萬分比,比如2000表示20% |
隨機字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
微信返回的隨機字符串 |
簽名 |
sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
微信返回的簽名,詳見簽名算法 |
舉例:
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<mch_id><![CDATA[10000100]]></mch_id>
<sub_mch_id><![CDATA[10000101]]></sub_mch_id>
<max_ratio><![CDATA[2000]]></max_ratio>
<nonce_str><![CDATA[6cefdb308e1e2e8aabd48cf79e546a02]]></nonce_str>
<sign><![CDATA[FE56DD4AA85C0EECA82C35595A69E153]]></sign>
</xml>
錯誤碼列表
名稱 |
描述 |
原因 |
解決方案 |
---|---|---|---|
SYSTEMERROR |
接口返回錯誤 |
系統(tǒng)超時 |
請使用相同參數(shù)再次調(diào)用API。 |
PARAM_ERROR |
參數(shù)錯誤 |
請求參數(shù)未按指引進(jìn)行填寫 |
請求參數(shù)錯誤,請檢查參數(shù)再調(diào)用分賬申請 |
NO_AUTH |
權(quán)限異常 |
服務(wù)商未開通分賬功能 |
請先開通分賬功能 |
服務(wù)商未與子商戶簽約 |
請先簽約子商戶 |
||
子商戶未開通分賬功能 |
請先開通子商戶的分賬功能 |