一、微信支付分介紹

最近更新時間：2023.5.11

微信用戶可以在具體應(yīng)用場景中，開通微信支付分。開通后，用戶可以在微信-錢包-支付分中查看分數(shù)和使用記錄。（即需在應(yīng)用場景中使用過一次，錢包才會出現(xiàn)支付分入口）

1.1 用戶在場景中開通示意圖

1.2 應(yīng)用場景

• 免押租借：適用于物品租借場景，例如共享充電寶、共享雨傘、線上租賃平臺等場景，用戶支付分達到商戶設(shè)置的分數(shù)門檻，即有機會獲得免交押金權(quán)益。
• 免押速?。哼m用于酒店行業(yè)，用戶支付分達到商戶設(shè)置的分數(shù)門檻，即有機會獲得免住宿押金，免預(yù)付房費等權(quán)益。
• 先享后付：適用于需預(yù)付費等場景，例如：網(wǎng)約車、寄快遞、電動車充電、共享按摩椅等，用戶支付分達到商戶設(shè)置的分數(shù)門檻，即有機會獲得先享受服務(wù)，后付款的權(quán)益。
• 智慧零售：適用于無人零售機柜，用戶支付分達到商戶設(shè)置的分數(shù)門檻，即有機會開柜購物。

1.3 間連模式支持開放行業(yè)場景

默認【需確認模式】支持行業(yè)場景：電商、出行、四輪充電樁、充電寶、線下共享設(shè)備、自助設(shè)備、酒旅；

二、接入流程

所有支付分場景商戶提交資料均需一戶一報備申請，商戶將資料提供給匯付由匯付申報。申請資料如下：

2.1 商戶需提交以下資料給機構(gòu)側(cè)申請

1. 商戶信息：
   
2. 場景信息：商戶準入需要符合以下的標準：
   

• 經(jīng)營類目、接入場景須符合支付分支持類目場景及提交商戶信息、場景信息。
• 商戶客服電話要通過微信支付認證，并展示在賬單詳情頁中。
• 接入商戶一個月內(nèi)整體投訴率<0.01%（含同主體）。
• 商戶主體無違規(guī)，通過W4標準

微信審核后會需要提交補充資料，具體補充資料以微信通知為準。
舉例：筆單金額及押金占比分布：
例如： 0-10元（85%） 10-50元 （12%） 50-99元（3%）或固定的押金金額及筆均。

2.2  微信側(cè)驗收及驗收要求

接入方與匯付聯(lián)調(diào)完成后要配合微信側(cè)做驗收，驗收通過才能上線。

2.2.1 場景使用流程-視頻

【第三人稱視角】需要按照如下要求提供用戶使用視頻材料：

• 用戶掃碼（含場景）→點擊目標產(chǎn)品→授權(quán)支付分→授權(quán)成功→跳轉(zhuǎn)詳情頁→成功
• 視頻內(nèi)容需清晰展示實際產(chǎn)品/業(yè)務(wù)所在場景，成功后需驗證消息通知；

舉例：機器→掃碼→啟動充電→結(jié)束充電，都應(yīng)清晰露出產(chǎn)品的位置和實體產(chǎn)品全貌

2.2.2 產(chǎn)品體驗流程-錄屏

【第一人稱視角】需要按照如下步驟提供用戶使用視頻材料：

1. 創(chuàng)建支付分訂單：用戶掃碼→詳情頁面→確認頁面→中間態(tài)→成功。 產(chǎn)品流需清晰錄屏并按照該場景的支付分《設(shè)計規(guī)范》，該狀態(tài)完成后，支付分訂單狀態(tài)為進行中，同時驗證消息通知+跳轉(zhuǎn)；
2. 完結(jié)支付分訂單：訂單狀態(tài)進行中→完結(jié)訂單→訂單完結(jié)成功→驗證消息通知

2.2.3 異常訂單體驗-錄屏

【第一人稱視角】需要按照如下情況提供用戶使用視頻材料：

訂單異常：訂單狀態(tài)為已創(chuàng)單或進行中→取消支付分訂單→取消成功→驗證訂單狀態(tài)→驗證消息通知
注：驗收為人工驗收，預(yù)計1-5工作日完成，請商戶先行查閱驗收要求。

2.3 微信側(cè)上線支付分服務(wù)

提供商戶上線的信息，格式如下：
商戶主體：
service_id：
商戶號：
商戶名稱：
1、預(yù)計上線時間：XX年XX月XX日    
2、上線計劃：
（1）上線城市和計劃：
（2）應(yīng)急機制：若遇緊急情況，商戶側(cè)是否支持隨時隱藏支付分入口
注：上線預(yù)計1-5個工作日完成

2.4 商戶側(cè)上線支付分服務(wù)

商戶側(cè)可自行安排灰度及全量上線支付分能力

三、接口說明

3.1 業(yè)務(wù)流程

3.2 服務(wù)訂單與扣款訂單

服務(wù)訂單是商戶的業(yè)務(wù)訂單，服務(wù)訂單完成后才能發(fā)起扣款訂單。服務(wù)訂單只能有一次支付成功的扣款訂單。

狀態(tài)變化：

• 創(chuàng)建、進行中：用戶主動取消服務(wù)，調(diào)用【取消支付分訂單】接口訂單狀態(tài)變?yōu)槿∠?/li>
• 進行中：用戶從商戶APP/小程序/網(wǎng)頁發(fā)起確認，調(diào)用【完成支付分訂單】接口，訂單狀態(tài)變?yōu)橐淹瓿桑?/li>
• 服務(wù)訂單已完成狀態(tài)之后才能發(fā)起支付，調(diào)用【登記扣款信息】；

3.3 調(diào)用流程

3.3.1 支付分訂單流程

1. 創(chuàng)建支付分訂單接口： ?商戶調(diào)用此接口創(chuàng)建支付分訂單，需提供服務(wù)信息、付費項目、優(yōu)惠信息等。調(diào)用前商戶需在斗拱開通微信支付分功能。
   a.  用戶在商戶側(cè)下單，商戶調(diào)用后臺接口創(chuàng)建支付分訂單，通過接口返回獲得跳轉(zhuǎn)微信支付分小程序進行訂單確認的必填參數(shù)“package”;
   ?b. 調(diào)用前端方法跳轉(zhuǎn)至微信，讓用戶完成確認訂單操作，APP調(diào)起支付分-確認訂單 、 JSAPI調(diào)起支付分-確認訂單 、小程序調(diào)起支付分-確認訂單
   如果長時間未收到用戶確認微信回調(diào)通知，可以調(diào)用【查詢支付分訂單接口】查詢狀態(tài)；
2. 申請完結(jié)訂單接口： ?用戶使用完商戶提供的產(chǎn)品或服務(wù)，在商戶的APP/小程序/H5頁面上確認訂單，商戶就可以調(diào)用本接口確認支付分訂單已完結(jié)。
3. 取消訂單接口： ?商戶的支付分訂單在"CREATED"或"DOING"狀態(tài)時可以取消訂單，商戶調(diào)用本接口實現(xiàn)訂單取消。注：此時還沒有進入向用戶扣款的支付流程；
4. 查詢支付分訂單接口： ?商戶創(chuàng)建支付分訂單后通過本接口查詢服務(wù)訂單的狀態(tài)。

注：通過【查詢支付分訂單接口】也可以主動查詢扣款情況。

• 如訂單狀態(tài)state=DONE，且收款狀態(tài)collection.state=USER_PAID，代表扣款成功
• 如訂單狀態(tài)state=DOING，state_description=MCH_COMPLETE，且收款狀態(tài)collection.state=USER_PAYING，代表扣款進行中

3.3.2 訂單支付流程

商戶扣款流程：

1. 登記扣款接口： ?用戶完結(jié)訂單后就進入支付分扣款流程?？劭盍鞒谭譃閮呻A段：先登記扣款信息，再調(diào)支付分扣款接口完成支付；
2. 支付分扣款接口： ?商戶登記扣款后用斗拱返回的扣款單號發(fā)起向用戶扣款。
3. 查詢扣款信息： ?商戶可以調(diào)本接口通過支付服務(wù)訂單查詢關(guān)聯(lián)的扣款訂單號；

用戶主動支付流程：

1. 交易結(jié)果通知： ?參見聚合正掃的間聯(lián)模式異步通知；
2. 微信支付成功回調(diào)通知： ?通過支付成功通知將用戶主動支付場景下的支付成功消息通知給商戶。

附件說明

交互圖樣例