最新更新時(shí)間:2022.04.11 版本說(shuō)明
商戶(hù)發(fā)起刪除分賬接收方請(qǐng)求。刪除后,不支持將分賬方商戶(hù)結(jié)算后的資金再分給該分賬接收方。
適用對(duì)象:直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/receivers
請(qǐng)求方式:delete
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
二級(jí)商戶(hù)號(hào) | sub_mchid | string[1, 32] | 否 | body微信支付分配的商戶(hù)號(hào),請(qǐng)與微信支付訂單的二級(jí)商戶(hù)號(hào)保持一致。(直連商戶(hù)不需要,服務(wù)商/機(jī)構(gòu)模式下必填) 示例值:1900000109 |
公眾賬號(hào)ID | appid | string[1, 32] | 否 | body與機(jī)構(gòu)商戶(hù)綁定的公眾賬號(hào)ID(AppID),平臺(tái)會(huì)校驗(yàn)該字段與機(jī)構(gòu)商之間是否存在有效綁定關(guān)系。分賬接收方類(lèi)型包含“PERSONAL_OPENID”時(shí)必填。 示例值:wx8888888888888888 |
二級(jí)商戶(hù)公眾賬號(hào)ID | sub_appid | string[1, 32] | 否 | body機(jī)構(gòu)服務(wù)商為二級(jí)商戶(hù)配置綁定的公眾賬號(hào)ID,平臺(tái)會(huì)校驗(yàn)機(jī)構(gòu)服務(wù)商、二級(jí)商戶(hù)和SubAppID之間的有效綁定關(guān)系。分賬接收方類(lèi)型包含“PERSONAL_SUB_OPENID”時(shí)必填。 示例值:wx8888888888888889 |
接收方類(lèi)型 | type | string | 是 | body接收方類(lèi)型 MERCHANT_ID:商戶(hù)號(hào), PERSONAL_OPENID:AppID對(duì)應(yīng)的OpenID PERSONAL_SUB_OPENID:SubAppID對(duì)應(yīng)的OpenID 示例值:MERCHANT_ID |
接收方賬號(hào) | account | string[1, 64] | 是 | body類(lèi)型是MERCHANT_ID時(shí),請(qǐng)?zhí)钊肷虘?hù)號(hào) 類(lèi)型是PERSONAL_OPENID時(shí),請(qǐng)?zhí)钊階ppID對(duì)應(yīng)的OpenID 類(lèi)型是PERSONAL_SUB_OPENID時(shí),請(qǐng)?zhí)钊隨ubAppID對(duì)應(yīng)的OpenID 示例值:86693852 |
{
"account": "1900000109",
"sub_mchid": "1900000109",
"type": "MERCHANT_ID"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 用戶(hù)類(lèi)型為PERSONAL_OPENID,參數(shù)appid未設(shè)置 | 用戶(hù)類(lèi)型為PERSONAL_OPENID,請(qǐng)?jiān)O(shè)置appid字段 |
400 | INVALID_REQUEST | 用戶(hù)類(lèi)型為PERSONAL_SUB_OPENID,參數(shù)sub_appid未設(shè)置 | 用戶(hù)類(lèi)型為PERSONAL_SUB_OPENID,請(qǐng)?jiān)O(shè)置sub_appid字段 |
400 | INVALID_REQUEST | 若接收方類(lèi)型為MERCHANT_ID,請(qǐng)?jiān)趎ame字段設(shè)置接收方商戶(hù)全稱(chēng) | 若接收方類(lèi)型為MERCHANT_ID,請(qǐng)?jiān)趎ame字段設(shè)置接收方商戶(hù)全稱(chēng) |
400 | INVALID_REQUEST | 若接收方類(lèi)型為MERCHANT_ID,請(qǐng)?jiān)趍ajor_service字段設(shè)置接收方商戶(hù)的主營(yíng)業(yè)務(wù)范圍 | 請(qǐng)檢查分賬接收方列表,去除同一次分賬請(qǐng)求中的重復(fù)賬戶(hù)后再執(zhí)行請(qǐng)求 |
400 | INVALID_REQUEST | 若接收方關(guān)系類(lèi)型為CUSTOM時(shí),請(qǐng)?jiān)O(shè)置custom_relation字段 | 若接收方關(guān)系類(lèi)型為CUSTOM時(shí),請(qǐng)?jiān)O(shè)置custom_relation字段 |
400 | INVALID_REQUEST | 個(gè)人接收方選擇傳入姓名字段但未確認(rèn)用戶(hù)授權(quán)狀態(tài) | 若選擇傳入個(gè)人接收方姓名以執(zhí)行用戶(hù)實(shí)名信息一致性校驗(yàn),需要商戶(hù)先獲取用戶(hù)授權(quán),并設(shè)置authorized字段為true |
400 | INVALID_REQUEST | 個(gè)人接收方在微信側(cè)的實(shí)名信息與傳入的姓名字段值不一致 | 請(qǐng)和接收方用戶(hù)確認(rèn)實(shí)名信息無(wú)誤后,再執(zhí)行請(qǐng)求 |
400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄,且預(yù)期最大分出比例(expected_ratio)與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶(hù)及預(yù)期最大分出比例是否填寫(xiě)正確,若已經(jīng)添加過(guò)該接收方,可通過(guò)【查詢(xún)分賬接收方添加結(jié)果API】查詢(xún)結(jié)果 |
400 | INVALID_REQUEST | 已經(jīng)存在一條分賬接收方方關(guān)系記錄,且上傳的審核文件ID字段(file_id)與本次請(qǐng)求不符 | 請(qǐng)檢查賬戶(hù)及審核文件ID字段(file_id)是否填寫(xiě)正確,若已經(jīng)添加過(guò)該接收方,可通過(guò)【查詢(xún)分賬接收方添加結(jié)果API】查詢(xún)結(jié)果 |
403 | NO_AUTH | 商戶(hù)未簽約境外分賬產(chǎn)品能力 | 請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備,確認(rèn)商戶(hù)具有分賬權(quán)限后再發(fā)起請(qǐng)求 |
403 | NO_AUTH | 商戶(hù)已開(kāi)通分賬產(chǎn)品能力,等待生效中(一般為第二天才生效) | 開(kāi)通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬,請(qǐng)等待第二天后發(fā)起請(qǐng)求 |
403 | NO_AUTH | 分賬接收方境外權(quán)限被處罰 | 請(qǐng)確認(rèn)分賬接收方均合法合規(guī)后,再發(fā)起請(qǐng)求 |
403 | NO_AUTH | 商戶(hù)父子關(guān)系不存在,請(qǐng)使用正確的二級(jí)商戶(hù)號(hào)發(fā)起請(qǐng)求 | 請(qǐng)檢查二級(jí)商戶(hù)號(hào)(sub_mchid)是否填寫(xiě)正確 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證