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

添加分賬接收方API

更新時間：2023.08.16

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

  1. 商戶需確保向微信支付傳輸用戶身份信息和賬號標識信息做一致性校驗已合法征得用戶授權

# 接口說明

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

# 請求參數(shù)

    Header HTTP頭參數(shù)
  • Authorization 必填 string
    請參考 簽名認證 生成認證信息
  • Accept 必填 string
    請設置為 application/json
  • Content-Type 必填 string
    請設置為 application/json
  • Wechatpay-Serial 必填 string
    【微信支付平臺證書序列號】 請求參數(shù)中的敏感字段，需要使用微信支付平臺證書公鑰加密。請設置為該證書的證書序列號。詳見敏感信息加解密
    Body 包體參數(shù)
  • appid 必填 string(32)
    【公眾賬號ID】 微信分配的公眾賬號ID
  • type 必填 string
    【接收方類型】 枚舉值：
    MERCHANT_ID：商戶ID
    PERSONAL_OPENID：個人openid（由父商戶APPID轉換得到）
    可選取值：
    • MERCHANT_ID: 商戶號
    • PERSONAL_OPENID: 個人OpenID（普通商戶由直連商戶AppID轉換得到，服務商模式由服務商AppID轉換得到）
    • PERSONAL_SUB_OPENID: 個人在子商戶應用下的OpenID（由子商戶AppID轉換得到，直連商戶不需要，僅服務商模式需要）
  • account 必填 string(64)
    【接收方賬號】 類型是MERCHANT_ID時，是商戶號
    類型是PERSONAL_OPENID時，是個人openid
    類型是PERSONAL_SUB_OPENID時，是個人sub_openid
  • name 選填 string(1024)
    【分賬接收方全稱】 分賬接收方類型是MERCHANT_ID時，是商戶全稱（必傳），當商戶是小微商戶或個體戶時，是開戶人姓名
    分賬接收方類型是PERSONAL_OPENID時，是個人姓名（選傳，傳則校驗）
    分賬接收方類型是PERSONAL_SUB_OPENID時，是個人姓名（選傳，傳則校驗）
    1、此字段需要加密，的加密方法詳見：敏感信息加密說明
    2、使用微信支付平臺證書中的公鑰
    3、使用RSAES-OAEP算法進行加密
    4、將請求中HTTP頭部的Wechatpay-Serial設置為證書序列號
  • relation_type 必填 string
    【與分賬方的關系類型】 子商戶與接收方的關系。
    本字段值為枚舉：
    SERVICE_PROVIDER：服務商
    STORE：門店
    STAFF：員工
    STORE_OWNER：店主
    PARTNER：合作伙伴
    HEADQUARTER：總部
    BRAND：品牌方
    DISTRIBUTOR：分銷商
    USER：用戶
    SUPPLIER：供應商
    CUSTOM：自定義
    可選取值：
    • SERVICE_PROVIDER: 服務商
    • STORE: 門店
    • STAFF: 員工
    • STORE_OWNER: 店主
    • PARTNER: 合作伙伴
    • HEADQUARTER: 總部
    • BRAND: 品牌方
    • DISTRIBUTOR: 分銷商
    • USER: 用戶
    • SUPPLIER: 供應商
    • CUSTOM: 自定義
  • custom_relation 選填 string(10)
    【自定義的分賬關系】 子商戶與接收方具體的關系，本字段最多10個字。
    當字段relation_type的值為CUSTOM時，本字段必填
    當字段relation_type的值不為CUSTOM時，本字段無需填寫

請求示例

POST

# 應答參數(shù)

    200OK
  • type 必填 string
    【接收方類型】 參考請求參數(shù)
    可選取值：
    • MERCHANT_ID: 商戶號
    • PERSONAL_OPENID: 個人OpenID（普通商戶由直連商戶AppID轉換得到，服務商模式由服務商AppID轉換得到）
    • PERSONAL_SUB_OPENID: 個人在子商戶應用下的OpenID（由子商戶AppID轉換得到，直連商戶不需要，僅服務商模式需要）
  • account 必填 string(64)
    【接收方賬號】 參考請求參數(shù)
  • name 選填 string(1024)
    【分賬接收方全稱】 參考請求參數(shù)。使用APIv3敏感信息加密說明
  • relation_type 必填 string
    【與分賬方的關系類型】 參考請求參數(shù)
    可選取值：
    • SERVICE_PROVIDER: 服務商
    • STORE: 門店
    • STAFF: 員工
    • STORE_OWNER: 店主
    • PARTNER: 合作伙伴
    • HEADQUARTER: 總部
    • BRAND: 品牌方
    • DISTRIBUTOR: 分銷商
    • USER: 用戶
    • SUPPLIER: 供應商
    • CUSTOM: 自定義
  • custom_relation 選填 string(10)
    【自定義的分賬關系】 參考請求參數(shù)

應答示例

200 OK

# 錯誤碼

# 公共錯誤碼

狀態(tài)碼 錯誤碼 描述 解決方案
400 PARAM_ERROR 參數(shù)錯誤 請根據(jù)錯誤提示正確傳入?yún)?shù)
400 INVALID_REQUEST HTTP 請求不符合微信支付 APIv3 接口規(guī)則 請參閱 接口規(guī)則
401 SIGN_ERROR 驗證不通過 請參閱 簽名常見問題
500 SYSTEM_ERROR 系統(tǒng)異常，請稍后重試 請稍后重試

# 業(yè)務錯誤碼

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