# 支付分接入流程大綱
# 1. 申請接入
商戶向weixinpay_scoreBD@tencent.com
發(fā)送郵件接入申請,微信側(cè)在7-10個工作日內(nèi)進(jìn)行評估并回復(fù)審核結(jié)果。申請需包含以下信息:
- 商戶基本信息
- 商戶簡介
- 使用支付分的產(chǎn)品方案
- 使用支付分的場景描述(含線上交互與邏輯圖/文檔)
- 商戶聯(lián)系人及聯(lián)系方式(姓名、微信號及對應(yīng)可添加微信的手機號)請按上述要求提供完整且準(zhǔn)確的信息,否則無法保證接入時效
申請接入詳情內(nèi)容請點擊查閱:商戶入駐須知-文字版 (opens new window)、商戶入駐須知-圖文版 (opens new window)
# 2. 協(xié)議簽署
商戶信息及業(yè)務(wù)場景審核通過后,商戶可登陸【微信支付-商戶平臺 (opens new window)】完成協(xié)議簽署。
(簽署指引:登陸【微信支付-商戶平臺 (opens new window)】 >產(chǎn)品中心>支付拓展工具>微信支付分>申請開通產(chǎn)品+簽署協(xié)議)
# 3. 技術(shù)對接及驗收
3.1. 商戶完成簽約,微信側(cè)會提供配置信息文檔,商戶查閱并填寫相關(guān)資料。
3.2. 微信側(cè)根據(jù)商戶填寫信息完成技術(shù)聯(lián)調(diào)過程中的服務(wù)ID(service_id)配置。商戶側(cè)配置測試號后開始技術(shù)聯(lián)調(diào)。
3.3. 商戶側(cè)開發(fā)測試完成后開始驗收及上線工作。流程如下:
產(chǎn)品方案驗收,需提供以下相關(guān)信息:
- 商戶側(cè)業(yè)務(wù)全流程視頻、錄屏。【商戶接入支付分須知 (opens new window)中(四)驗收要求】
- 商戶提供App(包括IOS和安卓)、小程序或H5的驗收環(huán)境,微信側(cè)將在驗收環(huán)境內(nèi)進(jìn)行驗收確認(rèn)。
確認(rèn)灰度時間并在約定時間灰度上線。
驗收完成后微信側(cè)即完成配置,產(chǎn)品正式上線,上線前商戶需填寫上線計劃(微信側(cè)提供模板)。
# 4、需確認(rèn)與免確認(rèn)模式說明
支付分的接口分為【需確認(rèn)訂單模式】和【免確認(rèn)訂單模式】兩種接口模式。通過本文檔,為商戶說明兩種模板的主要區(qū)別。
# 4.1. 接口調(diào)用權(quán)限說明
【免確認(rèn)訂單模式】是高級接口權(quán)限,需特殊申請才能使用。
使用支付分的行業(yè)/場景,目前只能調(diào)用【需確認(rèn)訂單模式】接口。
接口調(diào)用權(quán)限與服務(wù)ID相關(guān),在申請服務(wù)ID時,只有上述場景下的服務(wù)ID,才有權(quán)限調(diào)用【免確認(rèn)訂單模式】接口。即只有在上述場景下,創(chuàng)建支付分訂單API接口中need_user_confirm字段才能傳。
false:免確認(rèn)訂單。
# 4.2. 接口能力差異點
【需確認(rèn)訂單模式】:為訂單維度的授權(quán),是單次授權(quán)。用戶授權(quán)了當(dāng)前這一筆訂單后,商戶僅能針對當(dāng)前訂單調(diào)用一次支付分的訂單創(chuàng)建和完結(jié)(免密代扣)。
【免確認(rèn)單模式】:為商戶服務(wù)維度的授權(quán),是長期授權(quán)。用戶授權(quán)了該商戶服務(wù)后,商戶可以通過后臺接口進(jìn)行支付分的訂單創(chuàng)建和完結(jié)(免密代扣)。
# 4.3. 典型場景說明
【需確認(rèn)訂單模式】典型場景說明:
例如 免押租借場景,均是使用【需確認(rèn)訂單模式】,以租借充電寶為例。
用戶從商戶端(小程序/App/H5),跳入微信支付分頁面,即第二步【確認(rèn)訂單】頁面,在微信支付分的訂單確認(rèn)頁面,進(jìn)行授權(quán)。
授權(quán)成功,則成功創(chuàng)建一筆支付分訂單(確認(rèn)訂單成功),服務(wù)結(jié)束后,商戶可以調(diào)用支付分完結(jié)接口,對該筆訂單進(jìn)行完結(jié)扣費。
(每次使用,均需跳轉(zhuǎn)至確認(rèn)訂單頁面進(jìn)行授權(quán))
下次用戶需要使用服務(wù)(例如再次租借充電寶),用戶需要按上面流程,再次進(jìn)入到【確認(rèn)訂單】頁面,進(jìn)行授權(quán)。
【免確認(rèn)訂單模式】典型場景說明:
例如 網(wǎng)約車先乘后付,是使用的【免確認(rèn)訂單模式】
首次使用,用戶先從商戶端(小程序/App/H5),跳入微信支付分頁面,進(jìn)行商戶服務(wù)的授權(quán)。
授權(quán)成功后,商戶即可通過后臺接口,進(jìn)行支付分訂單的創(chuàng)建和完結(jié)。用戶無需再進(jìn)入支付分授權(quán)頁面進(jìn)行授權(quán)。
(后續(xù)使用,無需再跳微信支付分頁面進(jìn)行授權(quán))
只要用戶沒有解除商戶服務(wù)授權(quán),商戶都可以通過后臺接口進(jìn)行創(chuàng)單和完結(jié)訂單。
# 4.4. 模式及相關(guān)參數(shù)解說
【需確認(rèn)訂單模式】: 即先免模式(評估不通過可交押金)
對應(yīng)創(chuàng)建支付分訂單風(fēng)險金額名稱name:
- DEPOSIT:押金
- ADVANCE:預(yù)付款
- CASH_DEPOSIT:保證金
對應(yīng)創(chuàng)建支付分訂單是否需要用戶確認(rèn)need_user_confirm:
true:需確認(rèn)訂單
對應(yīng)創(chuàng)建支付分訂單用戶標(biāo)識OpenID是否必填:
需確認(rèn)訂單:不填
【免確認(rèn)訂單模式】: 即先享模式(評估不通過不可使用服務(wù))
對應(yīng)創(chuàng)建支付分訂單風(fēng)險金額名稱name:
ESTIMATE_ORDER_COST:預(yù)估訂單費用
對應(yīng)創(chuàng)建支付分訂單是否需要用戶確認(rèn)need_user_confirm:
false:免確認(rèn)訂單
對應(yīng)創(chuàng)建支付分訂單用戶標(biāo)識OpenID是否必填:
免確認(rèn)訂單:必填
# 5. 先免與先享模式說明
創(chuàng)單API中,有一個risk_fund 字段,其中name 字段,有先免和先享2種不同值
【先免模式】 是指:免押金、免預(yù)付款、免保證金等場景,例如免押金租借各類物品,免預(yù)付款可先預(yù)定定制商品,免保證金可先進(jìn)行物品拍賣等。 若評估不通過,則可直接在確認(rèn)訂單頁上進(jìn)行押金/預(yù)付款/保證金支付。
例如:
用戶支付成功,可以繼續(xù)進(jìn)行服務(wù)使用。
【先享模式】 是指評估不通過,不能通過繳納費用,繼續(xù)進(jìn)行服務(wù)使用。例如信用回收,用戶評估通過,可先獲得部分回收款,若評估不通過,則無法獲得。
例如:
用戶若評估不通過,只能返回商戶。
- 【需確認(rèn)訂單模式】:可傳 先免模式的字段
- 【免確認(rèn)訂單模式】:只可傳 先享模式字段
(免確認(rèn)訂單模式下,若評估不通過,會創(chuàng)單失敗,返回)
1{"code":"INVALID_REQUEST","message":"存在未完結(jié)訂單"} 2或3{"code":"INVALID_REQUEST","message":"綜合評估不通過"})
存在未完結(jié)訂單:指當(dāng)前用戶可能有其他未付款的支付分訂單或在其他商戶側(cè)創(chuàng)建了過多的支付分訂單,本次訂單評估有風(fēng)險,被風(fēng)控攔截。
綜合評估不通過:指因為其他的原因被風(fēng)控攔截。