最新更新時(shí)間：2020.04.30 版本說(shuō)明
1. 電商平臺(tái)可通過(guò)此接口添加分賬接收方，建立分賬接收方列表（最多可添加20000個(gè)分賬接收方）。后續(xù)通過(guò)發(fā)起分賬請(qǐng)求，將電商平臺(tái)下的二級(jí)商戶結(jié)算后的資金，分給分賬接收方列表中具體的分賬接收方。
2. 添加的分賬接收方統(tǒng)一都在電商平臺(tái)維度進(jìn)行管理，其他二級(jí)商戶，均可向該分賬接收方列表中的接收方進(jìn)行分賬，避免在二級(jí)商戶維度重復(fù)維護(hù)。
? 電商平臺(tái)需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)。
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/receivers/add
請(qǐng)求方式：POST
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 公眾賬號(hào)ID | appid | string[1,32] | 是 | body 電商平臺(tái)的appid（公眾號(hào)APPID或者小程序APPID） 示例值：wx8888888888888888 |
| 接收方類型 | type | string[1,32] | 是 | body 分賬接收方的類型，枚舉值： MERCHANT_ID：商戶 PERSONAL_OPENID：個(gè)人 示例值：MERCHANT_ID |
| 接收方賬號(hào) | account | string[1,64] | 是 | body 分賬接收方的賬號(hào) 類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人openid，openid獲取方法 示例值：190001001 |
| 接收方名稱 | name | string[1,256] | 條件選填 | body 分賬接收方的名稱，當(dāng)type為MERCHANT_ID時(shí)，接收方名稱是商戶全稱。 示例值：張三網(wǎng)絡(luò)公司 |
| 接收方名稱的密文 | encrypted_name | string[1,10240] | 否 | body
1、分賬接收方類型是PERSONAL_OPENID時(shí)，是個(gè)人姓名的密文（選傳，傳則校驗(yàn)） 此字段的加密的方式為： 2、使用微信支付平臺(tái)證書(shū)中的公鑰 3、使用RSAES-OAEP算法進(jìn)行加密 4、將請(qǐng)求中HTTP頭部的Wechatpay-Serial設(shè)置為證書(shū)序列號(hào) 字段加密: 使用APIv3定義的方式加密 示例值：hu89ohu89ohu89o |
| 與分賬方的關(guān)系類型 | relation_type | string[1,32] | 是 | body 子商戶與接收方的關(guān)系。 枚舉值： SUPPLIER：供應(yīng)商 DISTRIBUTOR：分銷商 SERVICE_PROVIDER：服務(wù)商 PLATFORM：平臺(tái) OTHERS：其他 示例值：SUPPLIER |
{
"appid": "wx8888888888888888",
"type": "MERCHANT_ID",
"account": "190001001",
"name": "張三網(wǎng)絡(luò)公司",
"relation_type": "SUPPLIER"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 接收方類型 | type | string[1,32] | 是 | 分賬接收方的類型，枚舉值： MERCHANT_ID：商戶 PERSONAL_OPENID：個(gè)人 示例值：MERCHANT_ID |
| 接收方賬號(hào) | account | string[1,64] | 是 | 分賬接收方的賬號(hào) 類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人openid 示例值：190001001 |
{
"type": "MERCHANT_ID",
"account": "190001001"
}
| 狀態(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)降低頻率后重試 |