1. 產品介紹
1.1 簡介
商戶要使用微信、支付寶的支付服務時需要先去微信、支付寶做入駐。斗拱提供了一站式的入駐接入。
1.2 應用場景
適用對象:需要入駐微信或支付寶的商戶。
支持:
- 間聯模式入駐:商戶通過服務商向微信、支付寶申請入駐;
- 直聯模式入駐:商戶直接向微信、支付寶提交入駐申請;
2. 接入前準備
2.1 商務準備
-
選擇接入模式
-
直簽模式:指商戶與匯付直接簽約。具體流程:商戶完成協議簽署后,將準備好的入網材料提供給匯付銷售人員,由匯付銷售人員發起商戶入網申請,待審核通過入網成功后,商戶聯系人將收到短信通知控臺賬號及密碼。
-
服務商模式:指服務商與匯付簽約,服務商通過接口或控臺方式完成商戶入網。具體流程:服務商完成協議簽署后,將準備好的入網材料提供給匯付銷售人員,由匯付銷售人員發起服務商入網申請,待審核通過入網成功后,服務商聯系人將收到短信通知控臺賬號及密碼。
-
在斗拱完成商戶進件入網
- 直簽模式:已有匯付銷售人員申請開通,商戶無須另行操作;
- 服務商模式:
- 控臺入網:參考服務商控臺進件流程,渠道商接入指引;
- API入網:企業商戶調用企業商戶基本信息入駐接口 、小微商戶調用個人商戶基本信息入駐接口 完成開戶、綁卡、結算配置。
2.2 對接準備
第一步:密鑰獲取
聯調之前需要先獲取公私鑰,參見公私解鑰參數獲取說明;
第二步:公共參數獲取
登錄服務商/商戶控臺后,可在開發設置-開發者信息中,獲取sys_id,product_id參數信息;
3. 開發指引
3.1 對接規范
調用匯付接口,均采取POST形式提交,數據格式統一為JSON格式,相關SDK及簽名方法見鏈接:
SDK示例:Java SDK
加簽驗簽:v2版接口加簽驗簽
3.2 系統調用流程
3.2.1 微信直連
微信特約商戶進件接口
入參關注字段:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
app_id | 開發者的應用ID | Y | 微信服務商的APPID; |
mch_id | 商戶號 | Y | 微信支付分配服務商的商戶號; |
wx_woa_secret | 服務商微信公眾號APPID對應密鑰 | N | 申請微信公眾號支付必填 |
返參關注字段:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
applyment_id | 微信支付申請單號 | N | 微信支付分配的申請單號,成功返回 |
微信關注配置接口
入參關注字段:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
bind_app_id_conf_list | 綁定APPID配置 | N | jsonArray格式 |
subscribe_conf_list | 關注配置 | N | jsonArray格式 |
pay_path_conf_list | 支付目錄配置 | N | jsonArray格式 |
注意返參【綁定APPID配置】【關注配置】【支付目錄配置】是分別返回的,有各自返回結果與報文;
3.2.2 微信間連
AT間連證書登記接口:
關注以下請參:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
pay_way | 開通類型 | Y | W:微信 A:支付寶;示例值:W |
app_id | 開發者的應用ID | Y | 支付寶:開發者應用ID,微信:服務商的APPID;示例值:wx3767c5bd01df5061 |
mch_id | 商戶號 | N | 服務商的商戶號,微信必傳;示例值:360634064 |
cert_sn | 證書序列號 | N | 請求證書序列號,可在服務商后臺查看到,微信必傳;示例值:20220818883326714 |
secret_key | 服務商密鑰 | N | 服務商密鑰,微信必傳;示例值:RERE202208182319 |
微信商戶配置接口:
關注以下請參:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
fee_type | 業務開通類型 | Y | 枚舉值參見《微信業務開通類型》說明 |
wx_woa_app_id | 公眾號支付Appid | C | 條件必填,示例值:wx3767c5bd01df5061 ;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同時為空 |
wx_woa_path | 微信公眾號授權目錄 | C | 條件必填,示例值:https://paas.huifu.com/shouyintai/demo/h5/;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同時為空 |
wx_woa_secret | 微信公眾號APPID對應的秘鑰 | N | 示例值:64afb60bef3a22ac282aa7880cdaca98 |
wx_applet_app_id | 微信小程序APPID | String | 條件必填,示例值:wx8523175fea790f10 ;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同時為空 |
wx_applet_secret | 微信小程序APPID對應的秘鑰 | N |
微信實名認證接口:
返參關注字段:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
applyment_id | 申請單編號 | String | 微信支付分配的申請單號,申請成功時返回; |
3.2.3 支付寶直連
換取應用授權令牌接口:
入參關注字段:
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
app_id | 開發者的應用ID | Y | 支付寶分配給開發者的應用ID;示例值:2021001153625042 |
oper_type | 操作類型 | Y | |
app_auth_code | 授權碼 | C | 授權碼,操作類型為0-換取令牌時必填,其它選填;示例值:123 |
app_auth_token | 應用授權令牌 | C | 應用授權令牌,操作類型為1-刷新令牌時,且該字段有值,將與數據庫值進行校驗;示例值:202208200312104378 |
申請當面付代簽約接口:
入參關注字段
參數 | 中文名 | 必填 | 說明 |
---|---|---|---|
direct_category | 支付寶經營類目 | Y | 示例值:A_A03_4582 ,詳情可參考 商家經營類目 中的“經營類目編碼” |
app_id | 開發者的應用ID | Y | 支付寶分配給開發者的應用ID;示例值:2021001153625042 |
order_ticket | 訂單授權憑證 | N | 訂單授權憑證,填寫則對應事務提交進入預授權模式;示例值:00ee2d475f374ad097ee0f1ac223fX00 |
sign_and_auth | 簽約且授權標識 | N | Y-簽約且授權,N-無簽約授權;示例值:Y |
account | 商戶賬號 | Y | isv代操作的商戶賬號,可以是支付寶賬號,也可以是pid(2088開頭)示例值:test@alipay.com |
app_auth_token | 應用授權令牌 | N | 詳見應用授權概述 |
3.2.4 支付寶間連
AT間連證書登記接口:
參見前文微信間連說明;
4. API列表
類型 | 功能 | 描述 |
---|---|---|
API | 微信商戶配置 | 間連模式,微信商戶配置 |
API | 微信配置查詢 | 間連模式,微信配置查詢 |
API | 微信實名認證 | 間連模式,微信實名認證 |
API | 微信實名認證狀態查詢 | 間連模式,微信實名認證狀態查詢 |
API | 支付寶實名申請提交 | 間連模式,支付寶實名申請提交 |
API | 支付寶實名申請單查詢 | 間連模式,支付寶實名申請單查詢 |
API | 證書登記 | 商戶直連微信支付寶前需要先登記 |
應用程序接口 | 微信特約商戶進件 | 直連模式,微信特約商戶進件接口 |
應用程序接口 | 查詢微信申請狀態 | 直連模式, 微信特約商戶進件查詢接口 |
應用程序接口 | 修改微信結算帳號 | 直連模式,修改微信結算帳號接口 |
應用程序接口 | 查詢微信結算賬戶 | 直連模式,查詢微信結算賬戶 |
應用程序接口 | 微信關注配置 | 直連模式,微信關注配置 |
應用程序接口 | 微信關注配置查詢 | 直連模式,微信關注配置查詢 |
應用程序接口 | 換取應用授權令牌 | 支付寶直連,換取應用授權令牌 |
應用程序接口 | 申請當面付代簽約 | 支付寶直連,申請當面付代簽約 |
應用程序接口 | 查詢申請狀態 | 支付寶直連-查詢申請狀態 |
應用程序接口 | 直付通商戶入駐 | 支付寶直連直付通產品商戶入駐 |
應用程序接口 | 直付通分賬關系綁定解綁 | 支付寶直連直付通產品分賬關系綁定解綁 |
應用程序接口 | 直付通分賬關系查詢 | 支付寶直連直付通產品分賬關系查詢 |