銀行特約商戶錄入API
應用場景
銀行服務商接入微信支付前需要將下屬特約商戶基本資料信息報備給微信,在微信支付側生成特約商戶識別碼后方可提交微信支付。特約商戶識別碼是區(qū)分子商戶交易、結算和清分的標志。
銀行服務商需先在管理后臺錄入渠道,渠道審核通過后,才可以錄入特約商戶。銀行特約商戶數量較多,一般采調用該API實現快速錄入(注意:普通商戶和普通服務商不可調用該接口 )。該接口有頻率1次/秒限制。
銀行服務商調用該接口將特約商戶資料提交微信側,微信根據提交的資料情況,判斷商戶資料正確性,返回識別碼;如商戶資料有誤,返回相應的錯誤碼。
接口鏈接
URL地址:https://api.mch.weixin.qq.com/secapi/mch/submchmanage?action=add
是否需要證書
是
請求參數
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
公眾賬號ID | appid | 是 | String(32) | wxd678efh567hg6787 | 銀行服務商的公眾賬號ID |
商戶號 | mch_id | 是 | String(32) | 1230000109 | 銀行服務商的商戶號 |
簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 通過簽名算法計算得出的簽名值,詳見簽名生成算法 |
商戶名稱 | merchant_name | 是 | String(50) | 商戶名稱 | 該名稱是公司主體全稱,綁定公眾號時會對主體一致性校驗 |
商戶簡稱 | merchant_shortname | 是 | String(20) | 商戶簡稱 | 該名稱是顯示給消費者看的商戶名稱 |
客服電話 | service_phone | 是 | String(20) | 075586010000 | 方便微信在必要時能聯(lián)系上商家,會在支付詳情展示給消費者 |
聯(lián)系人 | contact | 否 | String(10) | 聯(lián)系人 | 方便微信在必要時能聯(lián)系上商家。 |
聯(lián)系電話 | contact_phone | 否 | String(11) | 13000000000 | 方便微信在必要時能聯(lián)系上商家。 |
聯(lián)系郵箱 | contact_email | 否 | String(30) | test@test.com | 方便微信在必要時能聯(lián)系上商家。 |
渠道號 | channel_id | 是 | String(32) | 10100000 | 銀行為其渠道商申請(在服務商平臺申請,請見《渠道錄入指引》)的渠道標識.銀行直連商戶也需要單獨申請渠道號 |
經營類目 | business | 是 | String(10) | 101 | 行業(yè)類目,請?zhí)顚憣腎D,見詳細列表 |
聯(lián)系人微信賬號類型 | contact_wechatid_type | 否 | String(32) | type_openid | 如傳微信號,值為type_wechatid 如果“收款人微信賬號”要傳openid,值為type_openid |
聯(lián)系人微信賬號 | contact_wechatid | 否 | String(32) | OPENID_012312321 | 微信號:打開微信,在"個人信息"中查看到的"微信號" openid:需在服務商appid下通過OAUTH2.0接口獲取用戶的openid,此處傳openid的具體值 |
商戶備注 | merchant_remark | 是 | String(20) | 商戶的唯一備注 | 同一個受理機構,特約商戶“商戶備注”唯一。 商戶備注重復時,生成商戶識別碼失敗,并返回提示信息“商戶備注已存在,請修改后重新提交” |
1.除商戶名稱、商戶簡稱、聯(lián)系人、商戶備注的長度為中文字符個數,其他均為字節(jié)數
2.參數值用XML轉義或加CDATA標簽用于說明數據不被XML解析器解析。
返回結果
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信標識,非交易標識,交易是否成功需要查看result_code來判斷 |
返回信息 | return_msg | 否 | String(128) | 簽名失敗 | 返回信息,如非空,為錯誤原因 簽名失敗 參數格式校驗錯誤 |
以下字段在return_code為SUCCESS的時候有返回
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
商戶號 | mch_id | 是 | String(32) | 1900000109 | 調用接口提交的商戶號 |
商戶識別碼 | sub_mch_id | 是 | String(32) | 013467007045764 | 微信支付分配的商戶識別碼 |
處理結果 | result_code | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | SUCCESS/FAIL |
處理信息 | result_msg | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 結果信息描述。處理成功,錯誤原因提示等 |
錯誤列表:
名稱 | 描述 | 解決方案 |
---|---|---|
不支持http get方法 | 請使用post方法,請檢查后重新提交 | 開發(fā)聯(lián)調解決 |
Xml格式錯誤 | 輸入xml參數格式錯誤,請檢查后重新提交 | |
驗簽 | 簽名校驗失敗,請檢查后重試 | |
使用utf-8編碼格式 | XXX未使用UTF-8編碼,請檢查后重試 例如:商戶簡稱未使用UTF-8編碼,請檢查后重試 |
|
可以從utf-8轉為gbk | XXX中包含了非法字符,請檢查后重試 例如:商戶名稱中包含了非法字符,請檢查后重試 |
|
聯(lián)系人、商戶簡稱、商戶名稱需要通過敏感詞校驗 | 校驗商戶信息時發(fā)生系統(tǒng)錯誤,請嘗試再次調用 校對商戶信息時發(fā)生系統(tǒng)錯誤,請嘗試再次調用 你輸入的字段中包含違反法律法規(guī)的內容,請檢查后重新輸入 你輸入的字段中涉及敏感字眼,不符合相關規(guī)定,請檢查后重新輸入 該公司因違規(guī),暫不能接入微信支付,可聯(lián)系客服獲取更多詳情 該公司因受協(xié)議保護,暫不能通過該申請渠道接入微信支付,可聯(lián)系客服獲取更多詳情 你輸入的字段中涉及敏感字眼,不符合相關規(guī)定,請檢查后重新輸入 |
人工檢查過濾 |
長度限制 | XXX填寫有誤,請檢查后重新提交 | |
正則校驗 | XXX內容格式有誤,請檢查后重試 | |
錄入權限 | 暫無權限,請檢查后重試 | 檢查權限 |
需要證書 | 獲取客戶端證書序列號失敗 獲取客戶端證書特征名稱(DN)域失敗 證書校驗失敗,請檢查后重試 |
檢查證書 |