最新更新時(shí)間：2021.05.11 版本說明
服務(wù)商發(fā)起添加分賬接收方請求，建立分賬接收方列表。后續(xù)可通過發(fā)起分賬請求，將分賬方商戶結(jié)算后的資金，分到該分賬接收方
? 服務(wù)商需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)
適用對象：服務(wù)商
請求URL：https://api.mch.weixin.qq.com/v3/profitsharing/receivers/add
請求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號(hào) | sub_mchid | string[1,32] | 是 | body微信支付分配的子商戶號(hào)，即分賬的出資商戶號(hào)。 示例值：1900000109 |
| 應(yīng)用ID | appid | string[1, 32] | 是 | body微信分配的公眾賬號(hào)ID 示例值：wx8888888888888888 |
| 子商戶應(yīng)用ID | sub_appid | string[1, 32] | 否 | body子商戶的公眾賬號(hào)ID，分賬接收方類型包含PERSONAL_SUB_OPENID時(shí)必填 示例值：wx8888888888888889 |
| 分賬接收方類型 | type | string[1, 32] | 是 | body枚舉值： MERCHANT_ID：商戶ID PERSONAL_OPENID：個(gè)人openid（由父商戶APPID轉(zhuǎn)換得到） PERSONAL_SUB_OPENID：個(gè)人sub_openid（由子商戶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 |
| 分賬個(gè)人接收方姓名 | name | string[1, 1024] | 否 | body分賬接收方類型是MERCHANT_ID時(shí)，是商戶全稱（必傳），當(dāng)商戶是小微商戶或個(gè)體戶時(shí)，是開戶人姓名 分賬接收方類型是PERSONAL_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 分賬接收方類型是PERSONAL_SUB_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 1、此字段需要加密，加密方法詳見：敏感信息加密說明 2、使用微信支付平臺(tái)證書中的公鑰 3、使用RSAES-OAEP算法進(jìn)行加密 4、將請求中HTTP頭部的Wechatpay-Serial設(shè)置為證書序列號(hào) 示例值：hu89ohu89ohu89o |
| 與分賬方的關(guān)系類型 | relation_type | string[1, 32] | 是 | body子商戶與接收方的關(guān)系。 本字段值為枚舉： SERVICE_PROVIDER：服務(wù)商 STORE：門店 STAFF：員工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：總部 BRAND：品牌方 DISTRIBUTOR：分銷商 USER：用戶 SUPPLIER： 供應(yīng)商 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í)，本字段無需填寫 示例值：代理商 |
{
"sub_mchid": "1900000109",
"appid": "wx8888888888888888",
"sub_appid": "wx8888888888888889",
"type": "MERCHANT_ID",
"account": "86693852",
"name": "hu89ohu89ohu89o",
"relation_type": "SERVICE_PROVIDER",
"custom_relation": "代理商"
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號(hào) | sub_mchid | string[1, 32] | 是 | 微信支付分配的子商戶號(hào)，即分賬的出資商戶號(hào)。 示例值：1900000109 |
| 分賬接收方類型 | type | string[1, 32] | 是 | 枚舉值： MERCHANT_ID：商戶ID PERSONAL_OPENID：個(gè)人openid（由父商戶APPID轉(zhuǎn)換得到） PERSONAL_SUB_OPENID：個(gè)人sub_openid（由子商戶APPID轉(zhuǎn)換得到） 示例值：MERCHANT_ID |
| 分賬接收方賬號(hào) | account | string[1, 64] | 是 | 類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人openid 類型是PERSONAL_SUB_OPENID時(shí)，是個(gè)人sub_openid 示例值：86693852 |
| 分賬接收方全稱 | name | string[1, 1024] | 否 | 分賬接收方類型是MERCHANT_ID時(shí)，是商戶全稱（必傳），當(dāng)商戶是小微商戶或個(gè)體戶時(shí)，是開戶人姓名 分賬接收方類型是PERSONAL_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 分賬接收方類型是PERSONAL_SUB_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 1、此字段需要加密，加密方法詳見：敏感信息加密說明 2、使用微信支付平臺(tái)證書中的公鑰 3、使用RSAES-OAEP算法進(jìn)行加密 4、將請求中HTTP頭部的Wechatpay-Serial設(shè)置為證書序列號(hào) 示例值：hu89ohu89ohu89o |
| 與分賬方的關(guān)系類型 | relation_type | string[1, 32] | 是 | 子商戶與接收方的關(guān)系。 本字段值為枚舉： SERVICE_PROVIDER：服務(wù)商 STORE：門店 STAFF：員工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：總部 BRAND：品牌方 DISTRIBUTOR：分銷商 USER：用戶 SUPPLIER： 供應(yīng)商 CUSTOM：自定義 示例值：SERVICE_PROVIDER |
| 自定義的分賬關(guān)系 | custom_relation | string[1, 10] | 否 | 子商戶與接收方具體的關(guān)系，本字段最多10個(gè)字。 當(dāng)字段relation_type的值為CUSTOM時(shí)，本字段必填 當(dāng)字段relation_type的值不為CUSTOM時(shí)，本字段無需填寫 示例值：代理商 |
{
"sub_mchid": "1900000109",
"type": "MERCHANT_ID",
"account": "86693852",
"name": "hu89ohu89ohu89o",
"relation_type": "SERVICE_PROVIDER",
"custom_relation": "代理商"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 請求參數(shù)不符合參數(shù)格式 | 請使用正確的參數(shù)重新調(diào)用 |
| 400 | INVALID_REQUEST | 無效請求 | 請確認(rèn)分賬接收方是否存在 |
| 403 | NO_AUTH | 商戶無權(quán)限 | 請開通商戶號(hào)分賬權(quán)限 |
| 429 | RATELIMIT_EXCEED | 添加接收方頻率過高 | 請降低頻率后重試 |