商戶活動報名
最近更新時間：2023.7.24
1. 產品介紹
1.1 簡介
活動是指商戶參加微信、支付寶組織的優惠活動，商戶通過斗拱可以直接參加這些優惠活動。目前只支持微信、支付寶的活動。
AT優惠活動相關政策及報名材料
下載材料說明表格
業務流程圖：
1.2 應用場景
商戶希望參加由第三方組織的政策活動，獲得優惠的手續費率等。
2. 接入前準備
2.1業務開通及配置
斗拱支持在控臺上操作商戶活動報名與接口參加活動報名。控臺操作參見《商戶活動報名-控臺操作》。
以下只對要做活動報名的商戶做相關接口傳參時候的特殊說明。 商戶進件、入駐、實名認證相關操作請參考正常商戶進件、業務入駐、實名認證流程的說明。
2.2 對接準備
第一步：密鑰獲取
聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；
第二步：公共參數獲取
登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息;
3. 開發指引
3.1 對接規范
調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：
SDK示例：Java 開發工具包
加簽驗簽：v2版接口加簽驗簽
3.2 確認業務配置
3.3 系統接口說明
3.3.1 商戶進件
由于微信、支付寶的活動通常有行業或商戶類型的限制，這些是商戶進件時就確定的。
企業商戶基本信息入駐接口
請求參數關注以下字段：
| 參數 | 中文名 | 是否必填 | 說明 |
|---|---|---|---|
| ent_type | 公司類型 | 是 | 見表格 |
| mcc | 所屬行業 | 是 | 見表格 |
3.3.2 商戶業務入駐
商戶業務開通接口
請求參數關注以下字段：
| 參數 | 中文名 | 是否必填 | 說明 |
|---|---|---|---|
| +wx_conf_list | 微信配置對象 | ||
| pay_scene | 支付場景 | 是 | 見表格 |
| fee_rule_id | 費率規則id | 可選 | 如在進件時mcc已傳入準確的mcc，此處無需上傳； 如在進件時mcc未正確填寫參考表格； |
| +ali_conf_list | 支付寶配置對象 | ||
| pay_scene | 支付場景 | 是 | 1-線上掃碼 |
| mcc | 商戶經營類目 | 可選 | 如在進件時mcc已傳入準確的mcc，此處無需上傳； 如在進件時mcc未正確填寫，此處填寫參考表格； |
3.3.3 商戶微信支付寶實名認證
微信實名認證接口、支付寶實名申請提交
此處無特殊說明，按照正常流程完成微信/支付寶實名認證即可。
3.3.4 商戶活動報名
商戶活動報名（微信/支付寶）
1） 請求參數關注如下字段：
| 參數 | 中文名 | 必填 | 說明 |
|---|---|---|---|
| fee_type | 手續費類型 | 是 | 按照商戶實際入駐時候的類型上送： 1-標準費率線上 2-標準費率線下 3-非盈利費率，支付寶支持（如公辦醫院等） 7-校園餐飲，微信、支付寶都支持 9-非在線教培，只有微信支持； |
| pay_way | 支付通道 | 是 | 按照實際報名活動的通道選擇 W-微信，A-支付寶 |
| activity_type | 活動類型 | 是 | education_001 線下教培機構 school_canteen_002 教育行業學校主體食堂 campus_dining_001 教育行業非學校主體食堂 parking_001 停車繳費行業活動 private_healthcare_001 商業醫療行業活動 |
注：
-
以上具體對應關系及所需上送證照圖片參考表格；
-
其它說明：商戶活動報名提交后，可通過商戶活動報名查詢（微信/支付寶）接口，查詢活動報名結果，確認活動報名成功后，需要再調用商戶業務開通修改接口，修改商戶交易手續費費率，其中請求參數pay_scene支付場景同之前業務開通時上傳。
3.3.5 商戶業務開通修改
當商戶入駐時候的經營范圍不正確，可能導致商戶無法做商戶活動報名，或在后續交易過程中碰到微信支付寶的風險管控提醒，此時商戶需做經營范圍的修改，可通過渠道商控臺發起修改或通過調用接口進行修改。
請求參數關注如下字段：
| 參數 | 中文名 | 是否必填 | 說明 |
|---|---|---|---|
| +wx_conf_list | 微信配置對象 | ||
| fee_rule_id | 費率規則id | 可選 | 見表格 |
| +ali_conf_list | 支付寶配置對象 | ||
| MCC公司 | 商戶經營類目 | 可選 | 見表格 |
4. API列表
| 類型 |
接口名稱
|
描述 |
|---|---|---|
|
應用程序接口
|
企業商戶基本信息入駐 | 服務商通過此接口在匯付為企業類商戶進行基本信息開戶。傳入企業商戶基本資料和圖片資料，開通匯付賬號，為商戶綁定銀行卡、配置結算和取現等功能。若選擇發送短信給商戶，匯付將會以短信方式發送賬號、密碼、控臺地址至商戶聯系人手機號。 |
| 應用程序接口 | 商戶業務開通 | 商戶進件成功后開通支付方式、業務功能、配置費率；會觸發簽約流程。 |
| 應用程序接口 | 商戶業務修改 | 修改商戶的業務配置，包括支付方式、業務功能、手續費率，可能會觸發簽約流程。 |
| 應用程序接口 | 微信實名認證 | 商戶在微信側進行實名認證 |
| 應用程序接口 | 支付寶實名申請提交 | 商戶在支付寶側進行實名認證 |
| 應用程序接口 | 商戶活動報名（微信/支付寶） | 商戶報名參與微信、支付寶的政策活動 |
| 應用程序接口 | 商戶活動報名查詢（微信/支付寶） | 商戶報名活動查詢 |
