API字典 /分賬 / 添加分賬接收方API

添加分賬接收方API

最新更新時(shí)間：2024.02.27 版本說(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)模板增加分賬接收方承諾函。

注：支持2份證明材料分開(kāi)提交，將兩份資料分別使用文件上傳API進(jìn)行提交，獲取到文件標(biāo)識(shí)ID之后，填入【file_id】字段。

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)求。

1. 接口說(shuō)明

適用對(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傳參

2.請(qǐng)求參數(shù)

參數(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微信分配的商戶公眾賬號(hào)ID，分賬接收方類型包含PERSONAL_OPENID時(shí)必填。示例值：wx8888888888888888
二級(jí)商戶公眾賬號(hào)ID	sub_appid	string[1, 32]	否	Body微信分配的二級(jí)商戶公眾賬號(hào)ID，分賬接收方類型包含PERSONAL_SUB_OPENID時(shí)必填。示例值：wx8888888888888889
接收方類型	type	string	是	Body接收方類型。 MERCHANT_ID：商戶號(hào)， PERSONAL_OPENID：個(gè)人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個(gè)人Sub_OpenID，由二級(jí)商戶APPID轉(zhuǎn)換得到示例值：MERCHANT_ID
接收方賬號(hào)	account	string[1, 64]	是	Body類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人OpenID 類型是PERSONAL_SUB_OPENID時(shí)，是個(gè)人Sub_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)用戶信息一致性，降低分賬接收方填寫錯(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ú)需填寫示例值：代理商
分賬場(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若接收方類型為MERCHANT_ID，該字段為必填項(xiàng)。請(qǐng)?zhí)峤环仲~接收方的主要服務(wù)場(chǎng)景，以及發(fā)生分賬場(chǎng)景的公開(kāi)網(wǎng)頁(yè)鏈接、小程序名稱、公眾號(hào)名稱以及APPID（如有）。示例值：Tax preparation service, www.example.com, Mini program: WXG, APPID: wx8888888888888888
分賬接收方預(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

請(qǐng)求示例

添加商戶為接收方添加用戶為接收方


{
    "account": "1900000109",
    "expected_ratio": 1000,
    "application_file_id": "439d2325-f878-8960-8719-604ed42f1139",
    "partnership_file_id": "de851a06-5a38-9d31-a102-275a17c477de",
    "major_service": "APPID: wx888888888888",
    "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"
  }


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8", 
    "appid": "wx78898sdfwe9888835", 
    "relation_type": "CUSTOM", 
    "custom_relation": "特約主播", 
    "expected_ratio": 800, 
    "scene": "該分賬接收方為特約帶貨主播", 
    "name": "tdcUez3ov/jAzO2sDwLap6uc8d2itP6ffhoQzOa9LDzrMOqz/+reA79+e3aijKn0dQ2tPA391byJY6VqSaPhCpDJgvoawBYCNxkPR+ID9SYq/axfI4hN66aO/d8PWcKyEV/4AuVJEJ3ZIhvJXfnkoxmP6vF3yv7g1zS/IL1dTHCqY4X2tTpko4BRylcfz2Fi82CLbSegaB1h3SOsmstiC/wf2MM5rSnamgTAKA0a7w5+0QsvmNWbU9pVkOnHCGTGLUQFpDMpDvMtJS/f8vrrCPAeJa6ijwF7WLOqTV3cVWFYAtSC3iSDGyD7p2axHqsrirJo8fq63lYSRrTia1vgnA==",
    "authorized":true,
    "sub_mchid": "999968480",
    "type": "PERSONAL_OPENID"
}

3. 返回參數(shù)

參數(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：個(gè)人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：個(gè)人Sub_OpenID，由二級(jí)商戶APPID轉(zhuǎn)換得到示例值：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]	否	若接收方類型為MERCHANT_ID，該字段為必填項(xiàng)。請(qǐng)?zhí)峤环仲~接收方的主要服務(wù)場(chǎng)景，以及發(fā)生分賬場(chǎng)景的公開(kāi)網(wǎng)頁(yè)鏈接、小程序名稱、公眾號(hào)名稱以及APPID（如有）。示例值：Tax preparation service, www.example.com, Mini program: WXG, APPID: wx8888888888888888
分賬接收方預(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
添加接收方失敗的原因描述	fail_description	string[0, 2048]	否	只有當(dāng)state為AUDIT_FAILED時(shí)，才會(huì)出現(xiàn)添加接收方失敗原因的詳細(xì)說(shuō)明。請(qǐng)參考描述中的反饋和建議，修改您的請(qǐng)求并重新添加接收方。示例值：合作證書沒(méi)有蓋章，也不是原始版本的彩色掃描件。
增加分賬接收方申請(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":"INIT",
    "type":"PERSONAL_OPENID"
}


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8", 
    "type": "PERSONAL_OPENID"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

4. 錯(cuò)誤碼

狀態(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ù)范圍	若接收方類型為MERCHANT_ID，請(qǐng)?jiān)趍ajor_service字段設(shè)置接收方商戶的主營(yíng)業(yè)務(wù)范圍
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ù)期最大分出比例是否填寫正確，若已經(jīng)添加過(guò)該接收方，可通過(guò)【查詢分賬接收方添加結(jié)果API】查詢結(jié)果
400	INVALID_REQUEST	已經(jīng)存在一條分賬接收方關(guān)系記錄，且上傳的雙方合作關(guān)系合同文件ID字段（partnership_file_id）與本次請(qǐng)求不符	請(qǐng)檢查賬戶及雙方合作關(guān)系合同文件ID字段（partnership_file_id）是否填寫正確，若已經(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）是否填寫正確，若已經(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	商戶父子關(guān)系不存在，請(qǐng)使用正確的二級(jí)商戶號(hào)發(fā)起請(qǐng)求	請(qǐng)檢查二級(jí)商戶號(hào)(sub_mchid)是否填寫正確

頁(yè)面導(dǎo)航

語(yǔ)言

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

添加分賬接收方API

1. 接口說(shuō)明

2.請(qǐng)求參數(shù)

請(qǐng)求示例

3. 返回參數(shù)

返回示例

4. 錯(cuò)誤碼