商戶發(fā)起添加分賬接收方請(qǐng)求,建立分賬接收方列表。后續(xù)可通過(guò)發(fā)起分賬請(qǐng)求,將分賬方商戶結(jié)算后的資金,分到該分賬接收方
- 商戶需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)
# 接口說(shuō)明
支持商戶:
【普通服務(wù)商】
請(qǐng)求方式:
【POST】/v3/profitsharing/receivers/add
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問(wèn)就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問(wèn)異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Content-Type 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Wechatpay-Serial 必填 string【微信支付平臺(tái)證書(shū)序列號(hào)】 請(qǐng)求參數(shù)中的敏感字段,需要使用微信支付平臺(tái)證書(shū)公鑰加密。請(qǐng)?jiān)O(shè)置為該證書(shū)的證書(shū)序列號(hào)。詳見(jiàn)敏感信息加解密
Header HTTP頭參數(shù)
- sub_mchid 選填 string(32)【子商戶號(hào)】 微信支付分配的子商戶號(hào),即分賬的出資商戶號(hào)。(直連商戶不需要,服務(wù)商需要)
- appid 必填 string(32)【公眾賬號(hào)ID】 微信分配的公眾賬號(hào)ID
- sub_appid 選填 string(32)【子商戶公眾賬號(hào)ID】 子商戶的公眾賬號(hào)ID,分賬接收方類(lèi)型包含PERSONAL_SUB_OPENID時(shí)必填。(直連商戶不需要,服務(wù)商需要)
- type 必填 string【接收方類(lèi)型】 枚舉值:
MERCHANT_ID:商戶ID
PERSONAL_OPENID:個(gè)人openid(由父商戶APPID轉(zhuǎn)換得到)
PERSONAL_SUB_OPENID:個(gè)人sub_openid(由子商戶APPID轉(zhuǎn)換得到)
可選取值:MERCHANT_ID
: 商戶號(hào)PERSONAL_OPENID
: 個(gè)人OpenID(普通商戶由直連商戶AppID轉(zhuǎn)換得到,服務(wù)商模式由服務(wù)商AppID轉(zhuǎn)換得到)PERSONAL_SUB_OPENID
: 個(gè)人在子商戶應(yīng)用下的OpenID(由子商戶AppID轉(zhuǎn)換得到,直連商戶不需要,僅服務(wù)商模式需要)
- account 必填 string(64)【接收方賬號(hào)】 類(lèi)型是MERCHANT_ID時(shí),是商戶號(hào)
類(lèi)型是PERSONAL_OPENID時(shí),是個(gè)人openid
類(lèi)型是PERSONAL_SUB_OPENID時(shí),是個(gè)人sub_openid - name 選填 string(1024)【分賬接收方全稱】 分賬接收方類(lèi)型是MERCHANT_ID時(shí),是商戶全稱(必傳),當(dāng)商戶是小微商戶或個(gè)體戶時(shí),是開(kāi)戶人姓名
分賬接收方類(lèi)型是PERSONAL_OPENID時(shí),是個(gè)人姓名(選傳,傳則校驗(yàn))
分賬接收方類(lèi)型是PERSONAL_SUB_OPENID時(shí),是個(gè)人姓名(選傳,傳則校驗(yàn))
1、此字段需要加密,的加密方法詳見(jiàn):敏感信息加密說(shuō)明
2、使用微信支付平臺(tái)證書(shū)中的公鑰
3、使用RSAES-OAEP算法進(jìn)行加密
4、將請(qǐng)求中HTTP頭部的Wechatpay-Serial設(shè)置為證書(shū)序列號(hào) - relation_type 必填 string【與分賬方的關(guān)系類(lèi)型】 子商戶與接收方的關(guān)系。
本字段值為枚舉:
SERVICE_PROVIDER:服務(wù)商
STORE:門(mén)店
STAFF:?jiǎn)T工
STORE_OWNER:店主
PARTNER:合作伙伴
HEADQUARTER:總部
BRAND:品牌方
DISTRIBUTOR:分銷(xiāo)商
USER:用戶
SUPPLIER:供應(yīng)商
CUSTOM:自定義
可選取值:SERVICE_PROVIDER
: 服務(wù)商STORE
: 門(mén)店STAFF
: 員工STORE_OWNER
: 店主PARTNER
: 合作伙伴HEADQUARTER
: 總部BRAND
: 品牌方DISTRIBUTOR
: 分銷(xiāo)商USER
: 用戶SUPPLIER
: 供應(yīng)商CUSTOM
: 自定義
- custom_relation 選填 string(10)【自定義的分賬關(guān)系】 子商戶與接收方具體的關(guān)系,本字段最多10個(gè)字。
當(dāng)字段relation_type的值為CUSTOM時(shí),本字段必填
當(dāng)字段relation_type的值不為CUSTOM時(shí),本字段無(wú)需填寫(xiě)
Body 包體參數(shù)
請(qǐng)求示例
POST
# 應(yīng)答參數(shù)
- sub_mchid 選填 string(32)【子商戶號(hào)】 參考請(qǐng)求參數(shù)
- type 必填 string【接收方類(lèi)型】 參考請(qǐng)求參數(shù)
可選取值:MERCHANT_ID
: 商戶號(hào)PERSONAL_OPENID
: 個(gè)人OpenID(普通商戶由直連商戶AppID轉(zhuǎn)換得到,服務(wù)商模式由服務(wù)商AppID轉(zhuǎn)換得到)PERSONAL_SUB_OPENID
: 個(gè)人在子商戶應(yīng)用下的OpenID(由子商戶AppID轉(zhuǎn)換得到,直連商戶不需要,僅服務(wù)商模式需要)
- account 必填 string(64)【接收方賬號(hào)】 參考請(qǐng)求參數(shù)
- name 選填 string(1024)【分賬接收方全稱】 參考請(qǐng)求參數(shù)。使用APIv3敏感信息加密方式
- relation_type 必填 string【與分賬方的關(guān)系類(lèi)型】 參考請(qǐng)求參數(shù)
可選取值:SERVICE_PROVIDER
: 服務(wù)商STORE
: 門(mén)店STAFF
: 員工STORE_OWNER
: 店主PARTNER
: 合作伙伴HEADQUARTER
: 總部BRAND
: 品牌方DISTRIBUTOR
: 分銷(xiāo)商USER
: 用戶SUPPLIER
: 供應(yīng)商CUSTOM
: 自定義
- custom_relation 選填 string(10)【自定義的分賬關(guān)系】 參考請(qǐng)求參數(shù)
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過(guò) | 請(qǐng)參閱 簽名常見(jiàn)問(wèn)題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 無(wú)效請(qǐng)求 | 請(qǐng)確認(rèn)分賬接收方是否存在 |
400 | PARAM_ERROR | 請(qǐng)求參數(shù)不符合參數(shù)格式 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
403 | NO_AUTH | 商戶無(wú)權(quán)限 | 請(qǐng)開(kāi)通商戶號(hào)分賬權(quán)限 |
429 | FREQUENCY_LIMITED | 添加接收方頻率過(guò)高 | 請(qǐng)降低頻率后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |