微信支付-分賬

返回上一層文檔首頁 / 添加分賬接收方API

添加分賬接收方API

最新更新時(shí)間：2021.05.11 版本說明

商戶發(fā)起添加分賬接收方請(qǐng)求，建立分賬接收方列表。后續(xù)可通過發(fā)起分賬請(qǐng)求，將分賬方商戶結(jié)算后的資金，分到該分賬接收方

注意：

? 商戶需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)

接口說明

適用對(duì)象：直連商戶

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/profitsharing/receivers/add

請(qǐng)求方式：POST

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請(qǐng)求JSON傳參

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

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
應(yīng)用ID	appid	string[1, 32]	是	body微信分配的公眾賬號(hào)ID 示例值：wx8888888888888888
分賬接收方類型	type	string[1, 32]	是	body枚舉值： MERCHANT_ID：商戶ID PERSONAL_OPENID：個(gè)人openid（由父商戶APPID轉(zhuǎn)換得到）示例值：MERCHANT_ID
分賬接收方賬號(hào)	account	string[1, 64]	是	body類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人openid openid獲取方法示例值：86693852
分賬個(gè)人接收方姓名	name	string[1, 1024]	否	body分賬接收方類型是MERCHANT_ID時(shí)，是商戶全稱（必傳），當(dāng)商戶是小微商戶或個(gè)體戶時(shí)，是開戶人姓名分賬接收方類型是PERSONAL_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 1、此字段需要加密，加密方法詳見：敏感信息加密說明 2、使用微信支付平臺(tái)證書中的公鑰：獲取平臺(tái)證書 3、使用RSAES-OAEP算法進(jìn)行加密 4、將請(qǐng)求中HTTP頭部的Wechatpay-Serial設(shè)置為證書序列號(hào) 示例值：hu89ohu89ohu89o
與分賬方的關(guān)系類型	relation_type	string[1, 32]	是	body子商戶與接收方的關(guān)系。本字段值為枚舉： STORE：門店 STAFF：?jiǎn)T工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：總部 BRAND：品牌方 DISTRIBUTOR：分銷商 USER：用戶 SUPPLIER：供應(yīng)商 CUSTOM：自定義示例值：STORE
自定義的分賬關(guān)系	custom_relation	string[1, 10]	否	body子商戶與接收方具體的關(guān)系，本字段最多10個(gè)字。當(dāng)字段relation_type的值為CUSTOM時(shí)，本字段必填; 當(dāng)字段relation_type的值不為CUSTOM時(shí)，本字段無需填寫。示例值：代理商

請(qǐng)求示例

JSON


{
  "appid": "wx8888888888888888",
  "type": "MERCHANT_ID",
  "account": "86693852",
  "name": "hu89ohu89ohu89o",
  "relation_type": "STORE",
  "custom_relation": "代理商"
}


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
分賬接收方類型	type	string[1, 32]	是	枚舉值： MERCHANT_ID：商戶ID PERSONAL_OPENID：個(gè)人openid（由父商戶APPID轉(zhuǎn)換得到）示例值：MERCHANT_ID
分賬接收方賬號(hào)	account	string[1, 64]	是	類型是MERCHANT_ID時(shí)，是商戶號(hào) 類型是PERSONAL_OPENID時(shí)，是個(gè)人openid openid獲取方法示例值：86693852
分賬個(gè)人接收方姓名	name	string[1, 1024]	否	分賬接收方類型是MERCHANT_ID時(shí)，是商戶全稱（必傳），當(dāng)商戶是小微商戶或個(gè)體戶時(shí)，是開戶人姓名分賬接收方類型是PERSONAL_OPENID時(shí)，是個(gè)人姓名（選傳，傳則校驗(yàn)） 1、此字段需要加密，加密方法詳見：敏感信息加密說明 2、使用微信支付平臺(tái)證書中的公鑰：獲取平臺(tái)證書 3、使用RSAES-OAEP算法進(jìn)行加密 4、將請(qǐng)求中HTTP頭部的Wechatpay-Serial設(shè)置為證書序列號(hào) 示例值：hu89ohu89ohu89o
與分賬方的關(guān)系類型	relation_type	string[1, 32]	是	商戶與接收方的關(guān)系。本字段值為枚舉： STORE：門店 STAFF：?jiǎn)T工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：總部 BRAND：品牌方 DISTRIBUTOR：分銷商 USER：用戶 SUPPLIER：供應(yīng)商 CUSTOM：自定義示例值：STORE
自定義的分賬關(guān)系	custom_relation	string[1, 10]	否	子商戶與接收方具體的關(guān)系，本字段最多10個(gè)字。當(dāng)字段relation_type的值為CUSTOM時(shí)，本字段必填; 當(dāng)字段relation_type的值不為CUSTOM時(shí)，本字段無需填寫。示例值：代理商

返回示例

正常示例


{
  "type": "MERCHANT_ID",
  "account": "86693852",
  "name": "hu89ohu89ohu89o",
  "relation_type": "STORE"
}


http://2323weixin.qq.com

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(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	無效請(qǐng)求	請(qǐng)確認(rèn)分賬接收方是否存在
403	NO_AUTH	商戶無權(quán)限	請(qǐng)開通商戶號(hào)分賬權(quán)限
429	RATELIMIT_EXCEED	添加接收方頻率過高	請(qǐng)降低頻率后重試

技術(shù)咨詢

文檔反饋

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

微信支付商戶平臺(tái)