最新更新時間：2022.04.11 版本說明
商戶發(fā)起添加分賬接收方請求后，可通過調(diào)用本API來查詢分賬接收方添加結(jié)果。只有當(dāng)微信審核接收方材料通過，接收方關(guān)系狀態(tài)扭轉(zhuǎn)為EFFECTIVE后，才允許調(diào)用請求分賬API接口來分給該接收方。
適用對象：直連模式 機(jī)構(gòu)模式
請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/receivers/{account}
請求方式：get
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1, 32] | 否 | query微信支付分配的商戶號，請與微信支付訂單的二級商戶號保持一致。（直連商戶不需要，服務(wù)商/機(jī)構(gòu)模式下必填） 示例值：1900000109 |
| 公眾賬號ID | appid | string[1, 32] | 否 | query與機(jī)構(gòu)商戶綁定的公眾賬號ID(AppID)，平臺會校驗該字段與機(jī)構(gòu)商之間是否存在有效綁定關(guān)系。分賬接收方類型包含PERSONAL_OPENID時必填。 示例值：wx8888888888888888 |
| 二級商戶公眾賬號ID | sub_appid | string[1, 32] | 否 | query機(jī)構(gòu)服務(wù)商為二級商戶配置綁定的公眾賬號ID，平臺會校驗機(jī)構(gòu)服務(wù)商、二級商戶和SubAppID之間的有效綁定關(guān)系。分賬接收方類型包含PERSONAL_SUB_OPENID時必填。 示例值：wx8888888888888889 |
| 接收方類型 | type | string | 是 | query接收方類型 MERCHANT_ID：商戶號 PERSONAL_OPENID：個人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個人Sub_OpenID，由二級商戶APPID轉(zhuǎn)換得到 示例值：MERCHANT_ID |
| 接收方賬號 | account | string[1, 64] | 是 | path類型是MERCHANT_ID時，請?zhí)钊肷虘籼?br/>
類型是“PERSONAL_OPENID”時，請?zhí)钊階ppID對應(yīng)的OpenID 類型是“PERSONAL_SUB_OPENID”時，請?zhí)钊隨ubAppID對應(yīng)的OpenID 示例值：86693852 |
https://api.mch.weixin.qq.com/v3/global/profit-sharing/receivers/86693852?sub_mchid=1900000109&appid=wx8888888888888888&sub_appid=wx8888888888888889&type=MERCHANT_ID
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1, 32] | 否 | 二級商戶號，同請求入?yún)ⅰ?br/> 示例值：1900000109 |
| 接收方類型 | type | string | 是 | 接收方類型，同請求入?yún)ⅰ? MERCHANT_ID：商戶號 PERSONAL_OPENID：個人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個人Sub_OpenID，由二級商戶APPID轉(zhuǎn)換得到 示例值：MERCHANT_ID |
| 接收方賬號 | account | string[1, 64] | 是 | 接收方賬號，同請求入?yún)ⅰ?br/> 示例值：86693852 |
| 分賬接收方全稱 | name | string[1, 1024] | 否 | 分賬接收方全稱，同請求入?yún)ⅰ?br/> 示例值：hu89ohu89ohu89o |
| 與分賬方的關(guān)系類型 | relation_type | string | 是 | 與分賬方的關(guān)系類型，同請求入?yún)ⅰ? SUPPLIER：供應(yīng)商 DISTRIBUTOR：分銷商 TAX_SERVICE_PROVIDER：稅費服務(wù)商 IT_SERVICE_PROVIDER：技術(shù)服務(wù)提供方 CUSTOM：自定義 示例值：SUPPLIER |
| 自定義的分賬關(guān)系 | custom_relation | string[1, 10] | 否 | 自定義的分賬關(guān)系，同請求入?yún)ⅰ?br/> 示例值：代理商 |
| 分賬場景詳細(xì)描述 | scene | string[3, 256] | 是 | 分賬場景詳細(xì)描述，同請求入?yún)ⅰ?br/> 示例值：該分賬接收方是境內(nèi)稅費服務(wù)提供方，幫助商戶向境內(nèi)海關(guān)代扣代繳稅費。 |
| 接收方商戶的主營業(yè)務(wù)范圍 | major_service | string[3, 256] | 否 | 接收方商戶的主營業(yè)務(wù)范圍，同請求入?yún)ⅰ?br/> 示例值：稅務(wù)準(zhǔn)備服務(wù) |
| 分賬接收方預(yù)計分賬比例 | expected_ratio | int | 是 | 分賬接收方預(yù)計分賬比例，同請求入?yún)ⅰ?br/> 示例值：2000 |
| 微信文件標(biāo)識ID | file_id | string[10, 128] | 否 | 微信文件標(biāo)識ID，同請求入?yún)ⅰ?br/> 示例值：17b59418-b63c-4ac1-953a-d102dd2c80de |
| 接收方關(guān)系狀態(tài) | state | string | 是 | 分賬方與該接收方的關(guān)系狀態(tài)，僅允許對EFFECTIVE的接收方發(fā)起分賬。 INIT：待審核，等待微信審核接收方資料 EFFECTIVE：生效中，接收方關(guān)系生效中 AUDIT_FAILED：審核未通過，接收方審核未通過 示例值：AUDIT_FAILED |
| 接收關(guān)系添加失敗原因 | fail_reason | string | 否 | 添加分賬接收方失敗的原因，只有在state為AUDIT_FAILED時才會出現(xiàn) PARTNERSHIP_NOT_SUPPORTED：合作關(guān)系不支持，分賬接收方合作關(guān)系不支持分賬 DEFAULT_ERROR： 默認(rèn)錯誤， 示例值：PARTNERSHIP_NOT_SUPPORTED |
| 增加分賬接收方申請函文件ID | application_file_id | string[10, 128] | 否 | 增加分賬接收方申請函對應(yīng)的文件ID 示例值：439d2325-f878-8960-8719-604ed42f1139 |
| 分賬方與接收方合作關(guān)系證明文件ID | partnership_file_id | string[10, 128] | 否 | 分賬方與接收方合作關(guān)系證明文件ID 示例值：de851a06-5a38-9d31-a102-275a17c477de |
{
"account": "86693852",
"application_file_id": "439d2325-f878-8960-8719-604ed42f1139",
"custom_relation": "代理商",
"expected_ratio": 2000,
"fail_reason": "PARTNERSHIP_NOT_SUPPORTED",
"file_id": "17b59418-b63c-4ac1-953a-d102dd2c80de",
"major_service": "稅務(wù)準(zhǔn)備服務(wù)",
"name": "hu89ohu89ohu89o",
"partnership_file_id": "de851a06-5a38-9d31-a102-275a17c477de",
"relation_type": "SUPPLIER",
"scene": "該分賬接收方是境內(nèi)稅費服務(wù)提供方，幫助商戶向境內(nèi)海關(guān)代扣代繳稅費。",
"state": "AUDIT_FAILED",
"sub_mchid": "1900000109",
"type": "MERCHANT_ID"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 404 | NOT_FOUND | 分賬關(guān)系不存在 | 請檢查所傳賬戶、接受方類型等字段是否填寫正確 |
| 403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請求 |
| 403 | NO_AUTH | 商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效) | 開通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請等待第二天后發(fā)起請求 |
| 403 | NO_AUTH | 商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求 | 請檢查二級商戶號(sub_mchid)是否填寫正確 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證