API overview
本節將引導你安裝 APOLLO，以及 POS 如何與 APOLLO 整合。您可以開始構建您自己的應用整合，以便支持非接觸卡，接觸卡和電子錢包付款。
概覽
付款 API 使用 JSON 訊息與終端通信。
目前，您的應用只能通過 本地網絡 與 APOLLO 通信。我們正在計劃很快發布雲端付款 API，請關注 發布註釋。
開始之前
在開始進行 API 整合之前，您可以 聯繫我們 訂購一套 APOLLO 開發者套裝 (DevKit)。
請參考 APOLLO 硬件設備規範。
端點
本地通信端點使用以下格式：
http://{terminal_ip}:8080/sp/v1/{request}on port 8080 (http)
請求類型
目前，我們提供以下請求類型：
付款請求 -
/sp/v1/payment檢索最後交易 -
/sp/v1/enquiry/lasttransaction檢索特定交易 -
/sp/v1/enquiry/messageId={messageId}
付款流程
在整個 API 文檔中，我們假設以下實體是：
- POS - 您的應用，與 APOLLO SmartPOS 系統整合
- 銷售應用 & 付款核心 - 內置應用，可支持處理請求，處理交易，支持讀卡器和二維碼錢包攝像頭並支持持卡人驗證和連接到收單方主機。
- 商戶 - 使用 APOLLO 接受客戶付款的用戶。
付款流程如下：
- 商家使用 POS 設置收費金額。除此之外，商家還可以指定付款方式。
- POS 向銷售應用發送
付款請求，銷售應用應提供必要的數據。 - APOLLO 會切換屏幕進行交易處理，連接銀行，如有需要，還會進行持卡人驗證。
- 當交易完成時，應用返回
付款回覆到 POS。