最新更新時(shí)間：2022.06.14 版本說(shuō)明
商戶發(fā)起添加分賬接收方請(qǐng)求，建立分賬接收方列表。后續(xù)可通過(guò)發(fā)起分賬請(qǐng)求，將分賬方商戶結(jié)算后的資金，分給該分賬接收方。
1. 一份分賬接收關(guān)系涉及分賬方和接收方：
其中分賬方是指【發(fā)起方商戶】或【發(fā)起方商戶和其二級(jí)商戶】（直連商模式下為直連商戶號(hào)；服務(wù)商模式或境外機(jī)構(gòu)商模式下，為父商戶號(hào)以及二級(jí)商戶號(hào)）；
接收方是指接收分賬資金的個(gè)人微信賬號(hào)或商戶號(hào)，商戶在添加接收方信息時(shí)需提供接收方類型及接收方賬號(hào)；
以境外機(jī)構(gòu)商模式舉例，機(jī)構(gòu)商商戶A下有兩個(gè)二級(jí)商戶A1和A2已經(jīng)接入分賬服務(wù)，其中B1是A1商戶的合作方，B2是A2商戶的合作方；
——此時(shí)機(jī)構(gòu)商A為了實(shí)現(xiàn)A1商戶的分賬訂單分賬給B1，則需要添加以下分賬關(guān)系：mchid:A + sub_mchid: A1 + account: B1;
——為了實(shí)現(xiàn)A2商戶的分賬訂單分賬給B2，則需要添加：mchid:A + sub_mchid: A2 + account: B2;
2. 商戶在發(fā)起添加分賬接收方請(qǐng)求之前，需要先調(diào)用境外文件上傳API來(lái)提交接收方商戶的合作關(guān)系附件，以供微信進(jìn)行分賬接收關(guān)系的審核。請(qǐng)?zhí)崆皽?zhǔn)備如下合作關(guān)系材料，若資料上傳不齊全，可能審批不通過(guò)。
【合作關(guān)系材料說(shuō)明】
a. 雙方合作關(guān)系合同材料：
當(dāng)分賬接收方為境內(nèi)企業(yè)，需提交跨境電商與分賬接收方的合作合同的電子掃描件（必收）；當(dāng)分賬接收方為境內(nèi)個(gè)人，針對(duì)每個(gè)二級(jí)商戶（跨境電商）只需要提供一次跨境電商與某個(gè)境內(nèi)個(gè)人合作關(guān)系證明的樣例。
b. 分賬接收方申請(qǐng)函，詳見(jiàn)模板增加分賬接收方承諾函。
3. 調(diào)用本接口成功后，接收方關(guān)系狀態(tài)為INIT。待微信審核接收方材料通過(guò)，接收方關(guān)系狀態(tài)扭轉(zhuǎn)為EFFECTIVE后，方可調(diào)用請(qǐng)求分賬API接口來(lái)分給該接收方。可調(diào)用查詢分賬接收方添加結(jié)果API來(lái)確認(rèn)分賬接收方關(guān)系是否已經(jīng)生效（審核完成）。
4. 若接收方關(guān)系審核失敗，可根據(jù)審核失敗原因字段提示，重新在文件上傳API提交合規(guī)完整的審核材料后，重新發(fā)起添加接收方請(qǐng)求。注：INIT/EFFECTIVE狀態(tài)下的分賬接收方不允許再對(duì)該接收方發(fā)起添加請(qǐng)求。
適用對(duì)象：直連模式 機(jī)構(gòu)模式
請(qǐng)求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/receivers
請(qǐng)求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | body微信支付分配的商戶號(hào)，請(qǐng)與微信支付訂單的二級(jí)商戶號(hào)保持一致。（直連商戶不需要，服務(wù)商/機(jī)構(gòu)模式下必填） 示例值：1900000109 |
| 公眾賬號(hào)ID | appid | string[1, 32] | 否 | body與機(jī)構(gòu)商戶綁定的公眾賬號(hào)ID(AppID)，平臺(tái)會(huì)校驗(yàn)該字段與機(jī)構(gòu)商之間是否存在有效綁定關(guān)系。分賬接收方類型包含`PERSONAL_OPENID`時(shí)必填。 示例值：wx8888888888888888 |
| 二級(jí)商戶公眾賬號(hào)ID | sub_appid | string[1, 32] | 否 | body機(jī)構(gòu)服務(wù)商為二級(jí)商戶配置綁定的公眾賬號(hào)ID，平臺(tái)會(huì)校驗(yàn)機(jī)構(gòu)服務(wù)商、二級(jí)商戶和SubAppID之間的有效綁定關(guān)系。分賬接收方類型包含“PERSONAL_SUB_OPENID”時(shí)必填。 示例值：wx8888888888888889 |
| 接收方類型 | type | string | 是 | body接收方類型。 MERCHANT_ID：商戶號(hào)， PERSONAL_OPENID：AppID對(duì)應(yīng)的OpenID PERSONAL_SUB_OPENID：SubAppID對(duì)應(yīng)的OpenID 示例值：MERCHANT_ID |
| 接收方賬號(hào) | account | string[1, 64] | 是 | body類型是MERCHANT_ID時(shí)，請(qǐng)?zhí)钊肷虘籼?hào) 類型是“PERSONAL_OPENID”時(shí)，請(qǐng)?zhí)钊階ppID對(duì)應(yīng)的OpenID 類型是“PERSONAL_SUB_OPENID”時(shí)，請(qǐng)?zhí)钊隨ubAppID對(duì)應(yīng)的OpenID 示例值：86693852 |
| 分賬接收方全稱 | name | string[1, 1024] | 否 | body設(shè)置說(shuō)明： 1. 注：此字段需要加密，加密方法詳見(jiàn)文檔開(kāi)頭的：敏感信息加密說(shuō)明 2. 按照不同接收方類型，請(qǐng)按照如下說(shuō)明進(jìn)行設(shè)置： a. 分賬接收方類型是MERCHANT_ID時(shí)，是商戶全稱（必傳）； b. 分賬接收方類型是PERSONAL_OPENID或PERSONAL_SUB_OPENID時(shí)，是個(gè)人姓名（選傳，若傳入則會(huì)校驗(yàn)該字段值與微信支付側(cè)的實(shí)名信息是否一致，且需要設(shè)置authorized字段來(lái)確認(rèn)是否獲取用戶信息授權(quán)） 示例值：Merchant name |
| 是否已經(jīng)獲取用戶實(shí)名信息授權(quán) | authorized | boolean | 否 | body商戶向微信支付傳輸用戶姓名及賬戶信息，微信支付后臺(tái)將協(xié)助校驗(yàn)用戶信息一致性，降低分賬接收方填寫(xiě)錯(cuò)誤的風(fēng)險(xiǎn)。該字段為商戶確認(rèn)傳輸?shù)挠脩粜畔⒌氖跈?quán)狀態(tài)： 1）false代表未獲取用戶授權(quán)，微信支付將拒絕接收數(shù)據(jù) 2）true代表已獲取用戶授權(quán)，微信支付將正常接收數(shù)據(jù) 注意，當(dāng)接收方類型為用戶(PERSONAL_OPNEID/PERSONAL_SUB_OPENID)且選擇傳入賬戶名稱(即name字段)時(shí)，該字段為必填項(xiàng) 示例值：true |
| 與分賬方的關(guān)系類型 | relation_type | string | 是 | body分賬商戶與接收方的關(guān)系。 SUPPLIER：供應(yīng)商 DISTRIBUTOR：分銷商 TAX_SERVICE_PROVIDER：稅費(fèi)服務(wù)商 IT_SERVICE_PROVIDER：技術(shù)服務(wù)提供方 CUSTOM：自定義 示例值：SERVICE_PROVIDER |
| 自定義的分賬關(guān)系 | custom_relation | string[1, 10] | 否 | body分賬方與接收方具體的關(guān)系，本字段最多10個(gè)字。 當(dāng)字段relation_type的值為CUSTOM時(shí)，本字段必填 當(dāng)字段relation_type的值不為CUSTOM時(shí)，本字段無(wú)需填寫(xiě) 示例值：代理商 |
| 分賬場(chǎng)景詳細(xì)描述 | scene | string[3, 256] | 是 | body請(qǐng)商戶對(duì)于分賬場(chǎng)景進(jìn)行具體描述。 示例值：該分賬接收方是境內(nèi)稅費(fèi)服務(wù)提供方，幫助商戶向境內(nèi)海關(guān)代扣代繳稅費(fèi)。 |
| 接收方商戶的主營(yíng)業(yè)務(wù)范圍 | major_service | string[3, 256] | 否 | body描述該公司主體的主營(yíng)業(yè)務(wù)范圍。當(dāng)接收方類型為MERCHANT_ID時(shí)，本字段必填。 示例值：稅務(wù)準(zhǔn)備服務(wù) |
| 分賬接收方預(yù)計(jì)分賬比例 | expected_ratio | int | 是 | body指所添加的分賬接收方預(yù)計(jì)可能達(dá)到的最高分賬比例，此處僅作信息收集，不代表實(shí)際最高分賬比例，實(shí)際允許的最高分賬比例以平臺(tái)策略為準(zhǔn)。 單位萬(wàn)分比，比如2000表示20%。 示例值：2000 |
| 增加分賬接收方申請(qǐng)函文件ID | application_file_id | string[10, 128] | 否 | body請(qǐng)參考API開(kāi)頭的【材料提交方式說(shuō)明】。增加分賬接收方申請(qǐng)函對(duì)應(yīng)的文件ID，請(qǐng)使用文件上傳API進(jìn)行提交，獲取到文件標(biāo)識(shí)ID之后，再填入該字段。 示例值：439d2325-f878-8960-8719-604ed42f1139 |
| 分賬方與接收方合作關(guān)系證明文件ID | partnership_file_id | string[10, 128] | 否 | body請(qǐng)參考API開(kāi)頭的【材料提交方式說(shuō)明】。分賬方與接收方合作關(guān)系證明對(duì)應(yīng)的文件ID，若接收方類型為MERCHANT_ID，則該字段必填（若采用V1.0版本合并資料提交的方式則不做要求）；請(qǐng)使用文件上傳API進(jìn)行提交，獲取到文件標(biāo)識(shí)ID之后，再填入該字段。 示例值：de851a06-5a38-9d31-a102-275a17c477de |
{
"account": "1900000109",
"expected_ratio": 1000,
"partnership_file_id":"83f5c0f9-7c0d-4b3b-9136-ef16fd9cb644",
"application_file_id":"3a00187-426c-4815-8ea7-b0d1ef46647b",
"major_service": "稅務(wù)準(zhǔn)備服務(wù)",
"name": "tdcUez3ov/jAzO2sDwLap6uc8d2itP6ffhoQzOa9LDzrMOqz/+reA79+e3aijKn0dQ2tPA391byJY6VqSaPhCpDJgvoawBYCNxkPR+ID9SYq/axfI4hN66aO/d8PWcKyEV/4AuVJEJ3ZIhvJXfnkoxmP6vF3yv7g1zS/IL1dTHCqY4X2tTpko4BRylcfz2Fi82CLbSegaB1h3SOsmstiC/wf2MM5rSnamgTAKA0a7w5+0QsvmNWbU9pVkOnHCGTGLUQFpDMpDvMtJS/f8vrrCPAeJa6ijwF7WLOqTV3cVWFYAtSC3iSDGyD7p2axHqsrirJo8fq63lYSRrTia1vgnA==",
"relation_type": "TAX_SERVICE_PROVIDER",
"scene": "該分賬接收方是境內(nèi)稅費(fèi)服務(wù)提供方，幫助商戶向境內(nèi)海關(guān)代扣代繳稅費(fèi)。",
"sub_mchid": "999968480",
"type": "MERCHANT_ID"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | 二級(jí)商戶號(hào)，同請(qǐng)求入?yún)ⅰ?br/> 示例值：1900000109 |
| 接收方類型 | type | string | 是 | 接收方類型，同請(qǐng)求入?yún)ⅰ? MERCHANT_ID：商戶號(hào) PERSONAL_OPENID： AppID對(duì)應(yīng)的OpenID PERSONAL_SUB_OPENID：SubAppID對(duì)應(yīng)的OpenID 示例值：MERCHANT_ID |
| 接收方賬號(hào) | account | string[1, 64] | 是 | 接收方賬號(hào)，同請(qǐng)求入?yún)ⅰ?br/> 示例值：86693852 |
| 分賬接收方全稱 | name | string[1, 1024] | 否 | 分賬接收方全稱，同請(qǐng)求入?yún)ⅰ?br/> 示例值：hu89ohu89ohu89o |
| 與分賬方的關(guān)系類型 | relation_type | string | 是 | 與分賬方的關(guān)系類型，同請(qǐng)求入?yún)ⅰ? SUPPLIER：供應(yīng)商 DISTRIBUTOR：分銷商 TAX_SERVICE_PROVIDER：稅費(fèi)服務(wù)商 IT_SERVICE_PROVIDER：技術(shù)服務(wù)提供方 CUSTOM：自定義 示例值：SUPPLIER |
| 自定義的分賬關(guān)系 | custom_relation | string[1, 10] | 否 | 自定義的分賬關(guān)系，同請(qǐng)求入?yún)ⅰ?br/> 示例值：代理商 |
| 分賬場(chǎng)景詳細(xì)描述 | scene | string[3, 256] | 是 | 分賬場(chǎng)景詳細(xì)描述，同請(qǐng)求入?yún)ⅰ?br/> 示例值：該分賬接收方是境內(nèi)稅費(fèi)服務(wù)提供方，幫助商戶向境內(nèi)海關(guān)代扣代繳稅費(fèi)。 |
| 接收方商戶的主營(yíng)業(yè)務(wù)范圍 | major_service | string[3, 256] | 否 | 接收方商戶的主營(yíng)業(yè)務(wù)范圍，同請(qǐng)求入?yún)ⅰ?br/> 示例值：稅務(wù)準(zhǔn)備服務(wù) |
| 分賬接收方預(yù)計(jì)分賬比例 | expected_ratio | int | 是 | 分賬接收方預(yù)計(jì)分賬比例，同請(qǐng)求入?yún)ⅰ?br/> 示例值：2000 |
| 接收方關(guān)系狀態(tài) | state | string | 是 | 分賬方與該接收方的關(guān)系狀態(tài)，僅允許對(duì)EFFECTIVE的接收方發(fā)起分賬。 INIT：待審核，等待微信審核接收方資料 EFFECTIVE：生效中，接收方關(guān)系生效中 AUDIT_FAILED：審核未通過(guò)，接收方審核未通過(guò) 示例值：AUDIT_FAILED |
| 接收關(guān)系添加失敗原因 | fail_reason | string | 否 | 添加分賬接收方失敗的原因，只有在state為AUDIT_FAILED時(shí)才會(huì)出現(xiàn) PARTNERSHIP_NOT_SUPPORTED：合作關(guān)系不支持，分賬接收方合作關(guān)系不支持分賬 DEFAULT_ERROR：默認(rèn)錯(cuò)誤 示例值：PARTNERSHIP_NOT_SUPPORTED |
| 增加分賬接收方申請(qǐng)函文件ID | application_file_id | string[10, 128] | 否 | 增加分賬接收方申請(qǐng)函對(duì)應(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":"of8YZ6LPmjDmYAqdobIvwTdQQjR8",
"custom_relation":"特約主播",
"expected_ratio":800,
"relation_type":"CUSTOM",
"scene":"該分賬接收方為特約帶貨主播",
"state":"EFFECTIVE",
"sub_mchid": "999968480",
"type":"PERSONAL_OPENID",
"partnership_file_id":"83f5c0f9-7c0d-4b3b-9136-ef16fd9cb644",
"application_file_id":"3a00187-426c-4815-8ea7-b0d1ef46647b"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 用戶類型為PERSONAL_OPENID，參數(shù)appid未設(shè)置 | 用戶類型為PERSONAL_OPENID，請(qǐng)?jiān)O(shè)置appid字段 |
| 400 | INVALID_REQUEST | 用戶類型為PERSONAL_SUB_OPENID，參數(shù)sub_appid未設(shè)置 | 用戶類型為PERSONAL_SUB_OPENID，請(qǐng)?jiān)O(shè)置sub_appid字段 |
| 400 | INVALID_REQUEST | 若接收方類型為MERCHANT_ID，請(qǐng)?jiān)趎ame字段設(shè)置接收方商戶全稱 | 若接收方類型為MERCHANT_ID，請(qǐng)?jiān)趎ame字段設(shè)置接收方商戶全稱 |
| 400 | INVALID_REQUEST | 若接收方類型為MERCHANT_ID，請(qǐng)?jiān)趍ajor_service字段設(shè)置接收方商戶的主營(yíng)業(yè)務(wù)范圍 | 請(qǐng)檢查分賬接收方列表，去除同一次分賬請(qǐng)求中的重復(fù)賬戶后再執(zhí)行請(qǐng)求 |
| 400 | INVALID_REQUEST | 若接收方關(guān)系類型為CUSTOM時(shí)，請(qǐng)?jiān)O(shè)置custom_relation字段 | 若接收方關(guān)系類型為CUSTOM時(shí)，請(qǐng)?jiān)O(shè)置custom_relation字段 |
| 400 | INVALID_REQUEST | 個(gè)人接收方選擇傳入姓名字段但未確認(rèn)用戶授權(quán)狀態(tài) | 若選擇傳入個(gè)人接收方姓名以執(zhí)行用戶實(shí)名信息一致性校驗(yàn)，需要商戶先獲取用戶授權(quán)，并設(shè)置authorized字段為true |
| 400 | INVALID_REQUEST | 個(gè)人接收方在微信側(cè)的實(shí)名信息與傳入的姓名字段值不一致 | 請(qǐng)和接收方用戶確認(rèn)實(shí)名信息無(wú)誤后，再執(zhí)行請(qǐng)求 |
| 400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄，且預(yù)期最大分出比例（expected_ratio）與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶及預(yù)期最大分出比例是否填寫(xiě)正確，若已經(jīng)添加過(guò)該接收方，可通過(guò)【查詢分賬接收方添加結(jié)果API】查詢結(jié)果 |
| 400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄，且上傳的審核文件ID字段（file_id）與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶及審核文件ID字段（file_id）是否填寫(xiě)正確，若已經(jīng)添加過(guò)該接收方，可通過(guò)【查詢分賬接收方添加結(jié)果API】查詢結(jié)果 |
| 400 | INVALID_REQUEST | 傳入的AppID與發(fā)起商戶的綁定關(guān)系不存在 | 請(qǐng)確認(rèn)appid字段和發(fā)起方商戶是否綁定成功 |
| 400 | INVALID_REQUEST | 傳入的SubAppID與對(duì)應(yīng)二級(jí)商戶的綁定關(guān)系不存在 | 請(qǐng)確認(rèn)sub_appid字段和二級(jí)商戶是否綁定成功，機(jī)構(gòu)商可在商戶平臺(tái)>Institution>Application>對(duì)應(yīng)二級(jí)商戶的Development configuration上查看該二級(jí)商戶綁定的sub_appid |
| 400 | INVALID_REQUEST | 請(qǐng)商戶參照平臺(tái)指引提交分賬合作關(guān)系資料 | 請(qǐng)商戶參照平臺(tái)指引提交分賬合作關(guān)系資料 |
| 400 | INVALID_REQUEST | 請(qǐng)商戶參照平臺(tái)指引提交分賬合作關(guān)系資料中的“分賬接收方申請(qǐng)函” | 請(qǐng)商戶參照平臺(tái)指引提交分賬合作關(guān)系資料中的“分賬接收方申請(qǐng)函” |
| 400 | INVALID_REQUEST | 接收方用戶未實(shí)名認(rèn)證 | 添加用戶接收方時(shí)對(duì)應(yīng)的用戶未實(shí)名認(rèn)證，請(qǐng)引導(dǎo)用戶先進(jìn)行實(shí)名認(rèn)證，否則其微信零錢賬戶無(wú)法接受入金請(qǐng)求 |
| 400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄，且上傳的雙方合作關(guān)系合同文件ID字段（partnership_file_id）與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶及雙方合作關(guān)系合同文件ID字段（partnership_file_id）是否填寫(xiě)正確，若已經(jīng)添加過(guò)該接收方，可通過(guò)【查詢分賬接收方添加結(jié)果API】查詢結(jié)果 |
| 400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄，且上傳的分賬接收方申請(qǐng)函文件ID字段（application_file_id）與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶及分賬接收方申請(qǐng)函文件ID字段（application_file_id）是否填寫(xiě)正確，若已經(jīng)添加過(guò)該接收方，可通過(guò)【查詢分賬接收方添加結(jié)果API】查詢結(jié)果 |
| 403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請(qǐng)求 |
| 403 | NO_AUTH | 商戶已開(kāi)通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效) | 開(kāi)通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請(qǐng)等待第二天后發(fā)起請(qǐng)求 |
| 403 | NO_AUTH | 分賬接收方境外權(quán)限被處罰 | 請(qǐng)確認(rèn)分賬接收方均合法合規(guī)后，再發(fā)起請(qǐng)求 |
| 403 | NO_AUTH | 商戶父子關(guān)系不存在，請(qǐng)使用正確的二級(jí)商戶號(hào)發(fā)起請(qǐng)求 | 請(qǐng)檢查二級(jí)商戶號(hào)(sub_mchid)是否填寫(xiě)正確 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證