## **應用場景** ## 樂刷商戶開發平臺交易接口分為統一下單、條碼支付、交易結果查詢、支付通知、訂單關閉、退款、退款查詢、退款通知、授權碼查詢用戶openid。 ### **統一下單** 接口說明圖：  除付款碼支付場景以外，商戶系統先調用該接口在各支付服務后臺生成預支付交易單，返回正確的預支付交易會話標識后再按不同場景生成交易串調起支付 ### **條碼支付** 接口說明圖：  收銀員使用掃碼設備讀取用戶授權碼后，將授權碼傳送至商戶后臺，由商戶收銀臺或者后臺調用此接口進行支付 ### **交易結果查詢** 根據商戶訂單號或樂刷訂單號查詢支付結果 ### **支付通知** 通知 URL 是 3.1 和 3.2 中提交的參數 notify_url。支付成功后，樂刷會把相關支付信息和用戶信息發送到該 URL，商戶需要接收處理信息。對后臺通知交互時，如果收到商戶的應答不是成功或者超時，樂刷認為通知失敗，會通過一定的策略定期重新發起通知，盡可能的提高通知的成功率，但是不保證通知最終一定能成功。由于存在重復發送后臺通知的情況，因此同樣的通知可能會多次發送給商戶系統。系統必須能夠正確處理重復的通知。 ### **訂單關閉** 商戶訂單支付失敗需要生成新單號重新發起支付，要對原訂單號調用關單，避免重復支付；系統下單后，用戶支付超時，系統退出不再受理，避免用戶繼續，請調用關單接口。 ### **退款** 商戶針對某一筆已經成功支付的訂單發起退款，操作結果在同一會話中同步返回。支持部分退款。 ### **退款查詢** 提交退款申請后，通過該接口查詢退款狀態。退款有一定延時，請在退款后 1-3 個工作日內查詢退款狀態（此接口如果查詢到退款狀態為中間狀態時，會同步向上游查詢一次退款狀態）。 ### **退款通知** 通知 URL 是 4.6 中提交的參數 notify_url。退款成功或者失敗后，樂刷會把相關退款信息發送到該 URL，商戶需要接收處理信息。對后臺通知交互時，如果收到商戶的應答不是成功或者超時，樂刷認為通知失敗，會通 過一定的策略定期重新發起通知，盡可能的提高通知的成功率，但是不保證通知最終一定能成功。由于存在重復發送后臺通知的情況，因此同樣的通知可能會多次發送給商戶系統。系統必須能夠正確處理重復的通知。 ### **授權碼查詢用戶openid** Openid 名詞解釋：用戶在公眾號內的身份標識，不同公眾號擁有不同的 openid。商戶后臺系統通過登錄授權、支付通知、查詢訂單等 API 可獲取到用戶的 openid。主要用途是判斷同一個用戶，對用戶發送客服消息、模版消息等。可通過如下鏈接查看微信官方相關釋義。 [https://pay.weixin.qq.com/wiki/doc/api/micropay\_sl.php?chapter=2\_2](https://pay.weixin.qq.com/wiki/doc/api/micropay_sl.php?chapter=2_2)