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

添加分賬接收方

更新時(shí)間：2023.05.23

服務(wù)商可通過此接口添加分賬接收方，建立分賬接收方列表。連鎖加盟模式下，服務(wù)商添加的分賬接收方統(tǒng)一在品牌主商戶號(hào)維度進(jìn)行管理。


注意：
  1. 添加接收方成功后，后續(xù)通過發(fā)起分賬請(qǐng)求，品牌主及門店可以直接向分賬接收方列表中的接收方進(jìn)行分賬。
  2. 品牌主商戶號(hào)，系統(tǒng)默認(rèn)添加進(jìn)入分賬接收方列表，無需重復(fù)添加。
  3. 默認(rèn)支持品牌主商戶號(hào)向品牌下加盟的門店商戶號(hào)進(jìn)行分賬，無需添加門店為分賬接收方；上述條件需要品牌主商戶號(hào)和門店商戶號(hào)具有相同的服務(wù)商。其他門店需要參與分賬的場(chǎng)景，仍需將門店商戶號(hào)添加到分賬接收方列表中。
  4. 服務(wù)商需確保向微信支付傳輸用戶身份信息和賬號(hào)標(biāo)識(shí)信息做一致性校驗(yàn)已合法征得用戶授權(quán)

# 接口說明

支持商戶：
【普通服務(wù)商】
請(qǐng)求方式：
【POST】/v3/brand/profitsharing/receivers/add
請(qǐng)求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)
【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ，指引點(diǎn)擊查看

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

    Header HTTP頭參數(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
    Body 包體參數(shù)
  • brand_mchid 必填 string(32)
    【品牌主商戶號(hào)】 品牌主商戶號(hào)即綁定具體品牌的商戶號(hào)，填寫微信支付分配的商戶號(hào)
  • appid 必填 string(32)
    【公眾賬號(hào)ID】 微信分配的公眾賬號(hào)ID
  • sub_appid 選填 string(32)
    【子商戶公眾賬號(hào)ID】 品牌主的公眾賬號(hào)ID，分賬接收方類型包含PERSONAL_SUB_OPENID時(shí)必填
  • type 必填 string(32)
    【接收方類型】 分賬接收方類型，枚舉值：
    1. MERCHANT_ID：商戶號(hào)（mch_id或者sub_mch_id）
    2. PERSONAL_OPENID：個(gè)人OpenID（由服務(wù)商的AppID轉(zhuǎn)換得到）
    3. PERSONAL_SUB_OPENID：個(gè)人OpenID（由品牌主的AppID轉(zhuǎn)換得到）
  • account 必填 string(64)
    【接收方賬號(hào)】 分賬接收方賬號(hào)
    1. 分賬接收方類型為MERCHANT_ID時(shí)，分賬接收方賬號(hào)為商戶號(hào)（mch_id或者sub_mch_id）
    2. 分賬接收方類型為PERSONAL_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人OpenID（由服務(wù)商的AppID轉(zhuǎn)換得到）
    3. 分賬接收方類型為PERSONAL_SUB_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人OpenID（由品牌主的AppID轉(zhuǎn)換得到）
  • name 選填 string(256)
    【接收方名稱】 分賬接收方的名稱。
    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)。）
  • relation_type 必填 string(32)
    【與品牌主的關(guān)系類型】 枚舉值：
    - SUPPLIER：供應(yīng)商
    - DISTRIBUTOR：分銷商
    - SERVICE_PROVIDER：服務(wù)商
    - PLATFORM：平臺(tái)
    - STAFF：員工
    - OTHERS：其他

請(qǐng)求示例

POST

# 應(yīng)答參數(shù)

    200OK
  • brand_mchid 必填 string(32)
    【品牌主商戶號(hào)】 品牌主商戶號(hào)，即綁定具體品牌的商戶號(hào)，填寫微信支付分配的商戶號(hào)。
  • type 必填 string(32)
    【接收方類型】 分賬接收方類型，枚舉值：
    1. MERCHANT_ID：商戶號(hào)（mch_id或者sub_mch_id）
    2. PERSONAL_OPENID：個(gè)人OpenID（由服務(wù)商的AppID轉(zhuǎn)換得到）
    3. PERSONAL_SUB_OPENID：個(gè)人OpenID（由品牌主的AppID轉(zhuǎn)換得到）
  • account 必填 string(64)
    【接收方賬號(hào)】 分賬接收方賬號(hào)
    1. 分賬接收方類型為MERCHANT_ID時(shí)，分賬接收方賬號(hào)為商戶號(hào)（mch_id或者sub_mch_id）
    2. 分賬接收方類型為PERSONAL_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人OpenID（由服務(wù)商的AppID轉(zhuǎn)換得到）
    3. 分賬接收方類型為PERSONAL_SUB_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人OpenID（由品牌主的AppID轉(zhuǎn)換得到）

應(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)證不通過 請(qǐng)參閱 簽名常見問題
500 SYSTEM_ERROR 系統(tǒng)異常，請(qǐng)稍后重試 請(qǐng)稍后重試

# 業(yè)務(wù)錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
400 INVALID_REQUEST 無效請(qǐng)求 請(qǐng)確認(rèn)分賬接收方是否存在
400 PARAM_ERROR 請(qǐng)求參數(shù)不符合參數(shù)格式 請(qǐng)使用正確的參數(shù)重新調(diào)用
403 NO_AUTH 商戶無權(quán)限 請(qǐng)開通商戶號(hào)分賬權(quán)限
429 FREQUENCY_LIMITED 添加接收方頻率過高 請(qǐng)降低頻率后重試
500 SYSTEM_ERROR 系統(tǒng)錯(cuò)誤 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用