支付分的接口分為【需確認訂單模式】和【免確認訂單模式】兩種接口模式。通過本文檔,為商戶說明兩種模板的主要區(qū)別。
【免確認訂單模式】是高級接口權限,目前只支持如下行業(yè)調用:
行業(yè)/場景 | 說明 |
---|---|
網(wǎng)約車 | 網(wǎng)約車先乘后付 |
共享單車/電單車 | 共享單車/電單車先騎后付 |
快遞 | 快遞員用柜、用戶寄件 |
充電樁 | 電動汽車/二輪車充電樁 |
預訂平臺 | OTA,線上訂房平臺 |
機上購物 | 用戶機上離線購物 |
路邊停車 | 路邊停車 |
出行票務 | 乘車碼 |
電商 | 極速退款、先用后付 |
除以上行業(yè)/場景外,其他行業(yè)/場景均只能調用【需確認訂單模式】接口。
接口調用權限與服務id相關,在申請服務id時,只有上述場景下的服務id,才有權限調用【免確認單定模式】接口。即只有在上述場景下,創(chuàng)單訂單api接口中need_user_confirm字段才能傳
false:免確認訂單。
【需確認訂單模式】:為訂單維度的授權,是單次授權。用戶授權了當前這一筆訂單后,商戶僅能針對當前訂單調用一次支付分的訂單創(chuàng)建和完結(免密代扣)
【免確認單模式】:為商戶服務維度的授權,是長期授權。用戶授權了該商戶服務后,商戶可以通過后臺接口進行支付分的訂單創(chuàng)建和完結(免密代扣)
【需確認訂單模式】典型場景說明:
例如 免押租借場景,均是使用【需確認訂單模式】,以租借充電寶為例
用戶從商戶端(小程序/app/H5),跳入微信支付分頁面,即第二步【確認訂單】頁面,在微信支付分的訂單確認頁面,進行授權。
授權成功,則成功創(chuàng)建一筆支付分訂單(確認訂單成功),服務結束后,商戶可以調用支付分完結接口,對該筆訂單進行完結扣費。
(每次使用,均需跳確認訂單頁面進行授權)
下次用戶需要使用服務(例如再次租借充電寶),用戶需要按上面流程,再次進入到【確認訂單】頁面,進行授權。
【免確認訂單模式】典型場景說明:
例如 網(wǎng)約車先乘后付,是使用的【免確認訂單模式】
首次使用,用戶先從商戶端(小程序/app/H5),跳入微信支付分頁面,進行商戶服務的授權
授權成功后,商戶即可通過后臺接口,進行支付分訂單的創(chuàng)建和完結。用戶無需再進入支付分授權頁面進行授權。
(后續(xù)使用,無需再跳微信支付分頁面進行授權)
只要用戶沒有解除商戶服務授權,商戶都可以通過后臺接口進行創(chuàng)單和完結訂單。
創(chuàng)單api中,有一個risk_fund 字段,其中name 字段,有先免和先享2種不同值
【先免模式】是指:免押金、免預付款、免保證金等場景,例如免押金租借各類物品,免預付款可先預定定制商品,免保證金可先進行物品拍賣等。 若評估不通過,則可直接在 確認訂單頁上進行押金/預付款/保證金支付。
例如:
用戶支付成功,可以繼續(xù)進行服務使用。
【先享模式】是指評估不通過,不能通過繳納費用,繼續(xù)進行服務使用。例如信用回收,用戶評估通過,可先獲得部分回收款,若評估不通過,則無法獲得。
例如:
用戶若評估不通過,只能返回商戶。
【需確認訂單模式】:可傳先免模式的字段
【免確認訂單模式】:只可傳先享模式字段
(免確認訂單模式下,若評估不通過,會創(chuàng)單失敗,返回)
{"code":"INVALID_REQUEST","message":"存在未完結訂單}
或
{"code":"INVALID_REQUEST","message":"綜合評估不通過})
存在未完結訂單:指當前用戶可能有其他未付款的支付分訂單或在其他商戶側創(chuàng)建了過多的支付分訂單,本次訂單評估有風險,被風控攔截。
綜合評估不通過:指因為其他的原因被風控攔截。
【需確認訂單模式】:即先免模式(評估不通過可交押金)
對應創(chuàng)建支付分訂單風險金額名稱name:
DEPOSIT:押金
ADVANCE:預付款
CASH_DEPOSIT:保證金
對應創(chuàng)建支付分訂單是否需要用戶確認need_user_confirm:
true:需確認訂單
對應創(chuàng)建支付分訂單用戶標識openid是否必填:
需確認訂單:不填
【免確認訂單模式】:即先享模式(評估不通過不可使用服務)。
對應創(chuàng)建支付分訂單風險金額名稱name:
ESTIMATE_ORDER_COST:預估訂單費用
對應創(chuàng)建支付分訂單是否需要用戶確認need_user_confirm:
false:免確認訂單
對應創(chuàng)建支付分訂單用戶標識openid是否必填:
免確認訂單:必填