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