最新更新時(shí)間：2020.03.18 版本說(shuō)明
服務(wù)商可通過(guò)此接口添加分賬接收方，建立分賬接收方列表。連鎖加盟模式下，服務(wù)商添加的分賬接收方統(tǒng)一在品牌主商戶號(hào)維度進(jìn)行管理。
? 添加接收方成功后，后續(xù)通過(guò)發(fā)起分賬請(qǐng)求，品牌主及門(mén)店可以直接向分賬接收方列表中的接收方進(jìn)行分賬。
? 品牌主商戶號(hào)，系統(tǒng)默認(rèn)添加進(jìn)入分賬接收方列表，無(wú)需重復(fù)添加。
? 默認(rèn)支持品牌主商戶號(hào)向品牌下加盟的門(mén)店商戶號(hào)進(jìn)行分賬，無(wú)需添加門(mén)店為分賬接收方；上述條件需要品牌主商戶號(hào)和門(mén)店商戶號(hào)具有相同的服務(wù)商。其他門(mén)店需要參與分賬的場(chǎng)景，仍需將門(mén)店商戶號(hào)添加到分賬接收方列表中
? 服務(wù)商需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)
適用對(duì)象：服務(wù)商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/add
請(qǐng)求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌主商戶號(hào) | brand_mchid | string[1,32] | 是 | body 品牌主商戶號(hào)，即綁定具體品牌的商戶號(hào)，填寫(xiě)微信支付分配的商戶號(hào)。 示例值：1900000108 |
| 公眾賬號(hào)ID | appid | string[1,32] | 是 | body 微信分配的公眾賬號(hào)ID，這里指服務(wù)商的appid 示例值：wx8888888888888888 |
| 子商戶公眾賬號(hào)ID | sub_appid | string[1,32] | 否 | body 微信分配的子商戶公眾賬號(hào)ID，這里指品牌主的appid，分賬接收方類型包含PERSONAL_SUB_OPENID時(shí)必填。 示例值：wx8888888888888889 |
| 分賬接收方類型 | type | string[1,32] | 是 | body 枚舉值： MERCHANT_ID：商戶號(hào)（mch_id或者sub_mch_id） PERSONAL_OPENID：個(gè)人openid（由服務(wù)商的APPID轉(zhuǎn)換得到） PERSONAL_SUB_OPENID：個(gè)人sub_openid（由品牌主的APPID轉(zhuǎn)換得到） 示例值：MERCHANT_ID |
| 分賬接收方賬號(hào) | account | string[1,64] | 是 | body 1、分賬接收方類型為MERCHANT_ID時(shí)，分賬接收方賬號(hào)為商戶號(hào)（mch_id或者sub_mch_id） 2、分賬接收方類型為 PERSONAL_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人openid 3、分賬接收方類型為 PERSONAL_SUB_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人sub_openid 示例值：1900000109 |
| 接收方名稱 | name | string[1,256] | 否 | body 分賬接收方的名稱。 1、當(dāng)type為MERCHANT_ID時(shí)，接收方名稱必傳，且為商戶全稱。 2、當(dāng)type為PERSONAL_OPENID時(shí)，接收方名稱選傳，且為個(gè)人姓名。（傳入該字段時(shí)需要進(jìn)行校驗(yàn)。） 3、當(dāng)type為PERSONAL_SUB_OPENID時(shí)，接收方名稱選傳，且為個(gè)人姓名。（傳入該字段時(shí)需要進(jìn)行校驗(yàn)。） 示例值：張三網(wǎng)絡(luò)公司 |
| 與品牌主商戶的關(guān)系類型 | relation_type | string[1,32] | 是 | body 子商戶與接收方的關(guān)系。 枚舉值： SUPPLIER：供應(yīng)商 DISTRIBUTOR：分銷商 SERVICE_PROVIDER：服務(wù)商 PLATFORM：平臺(tái) STAFF：?jiǎn)T工 OTHERS：其他 示例值：SUPPLIER |
{
"brand_mchid": "1900000108",
"appid": "wx8888888888888888",
"sub_appid": "wx8888888888888889",
"type": "MERCHANT_ID",
"account": "1900000109",
"name": "張三網(wǎng)絡(luò)公司",
"relation_type": "SUPPLIER"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌主商戶號(hào) | brand_mchid | string[1,32] | 是 | 品牌主商戶號(hào)，即綁定具體品牌的商戶號(hào)，填寫(xiě)微信支付分配的商戶號(hào)。 示例值：1900000108 |
| 分賬接收方類型 | type | string[1,32] | 是 | 枚舉值： MERCHANT_ID：商戶號(hào)（mch_id或者sub_mch_id） PERSONAL_OPENID：個(gè)人openid（由服務(wù)商的APPID轉(zhuǎn)換得到） PERSONAL_SUB_OPENID：個(gè)人sub_openid（由品牌主的APPID轉(zhuǎn)換得到） 示例值：MERCHANT_ID |
| 分賬接收方賬號(hào) | account | string[1,64] | 是 | 1、分賬接收方類型為MERCHANT_ID時(shí)，分賬接收方賬號(hào)為商戶號(hào)（mch_id或者sub_mch_id） 2、分賬接收方類型為PERSONAL_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人openid 3、分賬接收方類型為 PERSONAL_SUB_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人sub_openid 示例值：1900000109 |
{
"brand_mchid": "1900000108",
"type": "MERCHANT_ID",
"account": "1900000109"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 請(qǐng)求參數(shù)不符合參數(shù)格式 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| 400 | INVALID_REQUEST | 無(wú)效請(qǐng)求 | 請(qǐng)確認(rèn)分賬接收方是否存在 |
| 403 | NO_AUTH | 商戶無(wú)權(quán)限 | 請(qǐng)開(kāi)通商戶號(hào)分賬權(quán)限 |
| 429 | FREQUENCY_LIMITED | 添加接收方頻率過(guò)高 | 請(qǐng)降低頻率后重試 |