一、微信支付分介紹
最近更新時間：2023.5.11
微信用戶可以在具體應用場景中，開通微信支付分。開通后，用戶可以在微信-錢包-支付分中查看分數和使用記錄。（即需在應用場景中使用過一次，錢包才會出現支付分入口）
1.1 用戶在場景中開通示意圖
1.2 應用場景
- 免押租借：適用于物品租借場景，例如共享充電寶、共享雨傘、線上租賃平臺等場景，用戶支付分達到商戶設置的分數門檻，即有機會獲得免交押金權益。
- 免押速住：適用于酒店行業，用戶支付分達到商戶設置的分數門檻，即有機會獲得免住宿押金，免預付房費等權益。
- 先享后付：適用于需預付費等場景，例如：網約車、寄快遞、電動車充電、共享按摩椅等，用戶支付分達到商戶設置的分數門檻，即有機會獲得先享受服務，后付款的權益。
- 智慧零售：適用于無人零售機柜，用戶支付分達到商戶設置的分數門檻，即有機會開柜購物。
1.3 間連模式支持開放行業場景
默認【需確認模式】支持行業場景：電商、出行、四輪充電樁、充電寶、線下共享設備、自助設備、酒旅；
二、接入流程
所有支付分場景商戶提交資料均需一戶一報備申請，商戶將資料提供給匯付由匯付申報。申請資料如下：
2.1 商戶需提交以下資料給機構側申請
- 商戶信息：
- 場景信息：商戶準入需要符合以下的標準：
- 經營類目、接入場景須符合支付分支持類目場景及提交商戶信息、場景信息。
- 商戶客服電話要通過微信支付認證，并展示在賬單詳情頁中。
- 接入商戶一個月內整體投訴率<0.01%（含同主體）。
- 商戶主體無違規，通過W4標準
微信審核后會需要提交補充資料，具體補充資料以微信通知為準。
舉例：筆單金額及押金占比分布：
例如： 0-10元（85%） 10-50元 （12%） 50-99元（3%）或固定的押金金額及筆均。
2.2 微信側驗收及驗收要求
接入方與匯付聯調完成后要配合微信側做驗收，驗收通過才能上線。
2.2.1 場景使用流程-視頻
【第三人稱視角】需要按照如下要求提供用戶使用視頻材料：
- 用戶掃碼（含場景）→點擊目標產品→授權支付分→授權成功→跳轉詳情頁→成功
- 視頻內容需清晰展示實際產品/業務所在場景，成功后需驗證消息通知；
舉例：機器→掃碼→啟動充電→結束充電，都應清晰露出產品的位置和實體產品全貌
2.2.2 產品體驗流程-錄屏
【第一人稱視角】需要按照如下步驟提供用戶使用視頻材料：
- 創建支付分訂單：用戶掃碼→詳情頁面→確認頁面→中間態→成功。 產品流需清晰錄屏并按照該場景的支付分《設計規范》，該狀態完成后，支付分訂單狀態為進行中，同時驗證消息通知+跳轉；
- 完結支付分訂單：訂單狀態進行中→完結訂單→訂單完結成功→驗證消息通知
2.2.3 異常訂單體驗-錄屏
【第一人稱視角】需要按照如下情況提供用戶使用視頻材料：
訂單異常：訂單狀態為已創單或進行中→取消支付分訂單→取消成功→驗證訂單狀態→驗證消息通知
注：驗收為人工驗收，預計1-5工作日完成，請商戶先行查閱驗收要求。
2.3 微信側上線支付分服務
提供商戶上線的信息，格式如下：
商戶主體：
service_id：
商戶號：
商戶名稱：
1、預計上線時間：XX年XX月XX日
2、上線計劃：
（1）上線城市和計劃：
（2）應急機制：若遇緊急情況，商戶側是否支持隨時隱藏支付分入口
注：上線預計1-5個工作日完成
2.4 商戶側上線支付分服務
商戶側可自行安排灰度及全量上線支付分能力
三、接口說明
3.1 業務流程
3.2 服務訂單與扣款訂單
服務訂單是商戶的業務訂單，服務訂單完成后才能發起扣款訂單。服務訂單只能有一次支付成功的扣款訂單。
狀態變化：
- 創建、進行中：用戶主動取消服務，調用【取消支付分訂單】接口訂單狀態變為取消；
- 進行中：用戶從商戶APP/小程序/網頁發起確認，調用【完成支付分訂單】接口，訂單狀態變為已完成；
- 服務訂單已完成狀態之后才能發起支付，調用【登記扣款信息】；
3.3 調用流程
3.3.1 支付分訂單流程
- 創建支付分訂單接口： ?商戶調用此接口創建支付分訂單，需提供服務信息、付費項目、優惠信息等。調用前商戶需在斗拱開通微信支付分功能。
a. 用戶在商戶側下單，商戶調用后臺接口創建支付分訂單，通過接口返回獲得跳轉微信支付分小程序進行訂單確認的必填參數“package”;
?b. 調用前端方法跳轉至微信，讓用戶完成確認訂單操作，APP調起支付分-確認訂單 、 JSAPI調起支付分-確認訂單 、小程序調起支付分-確認訂單
如果長時間未收到用戶確認微信回調通知，可以調用【查詢支付分訂單接口】查詢狀態； - 申請完結訂單接口： ?用戶使用完商戶提供的產品或服務，在商戶的APP/小程序/H5頁面上確認訂單，商戶就可以調用本接口確認支付分訂單已完結。
- 取消訂單接口： ?商戶的支付分訂單在"CREATED"或"DOING"狀態時可以取消訂單，商戶調用本接口實現訂單取消。注：此時還沒有進入向用戶扣款的支付流程；
- 查詢支付分訂單接口： ?商戶創建支付分訂單后通過本接口查詢服務訂單的狀態。
注：通過【查詢支付分訂單接口】也可以主動查詢扣款情況。
- 如訂單狀態state=DONE，且收款狀態collection.state=USER_PAID，代表扣款成功
- 如訂單狀態state=DOING，state_description=MCH_COMPLETE，且收款狀態collection.state=USER_PAYING，代表扣款進行中
3.3.2 訂單支付流程
商戶扣款流程：
- 登記扣款接口： ?用戶完結訂單后就進入支付分扣款流程。扣款流程分為兩階段：先登記扣款信息，再調支付分扣款接口完成支付；
- 支付分扣款接口： ?商戶登記扣款后用斗拱返回的扣款單號發起向用戶扣款。
- 查詢扣款信息： ?商戶可以調本接口通過支付服務訂單查詢關聯的扣款訂單號；
用戶主動支付流程：
- 交易結果通知： ?參見聚合正掃的間聯模式異步通知；
- 微信支付成功回調通知： ?通過支付成功通知將用戶主動支付場景下的支付成功消息通知給商戶。
附件說明
交互圖樣例
