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

添加分賬接收方API

更新時(shí)間:2023.08.16

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

  1. 商戶需確保向微信支付傳輸用戶身份信息和賬號(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ù)

    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
  • 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)敏感信息加解密
    Body 包體參數(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ě)

請(qǐng)求示例

POST

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

    200OK
  • 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ù)

應(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)用