悠遊卡操作
使用intella所提供的讀卡機, 可以透過Scan2Pay API進行交易, 無須與讀卡機實體進行整合, 免除開發讀卡機控制以及送驗證的時間, 可以快速將電子票證支付整合到結帳系統中.
intella所提供的讀卡機, 使用Wifi連線到區域網路中的無線Wifi AP, 可以使用Scan2Pay App進行設定. 設定方法請參考設定說明.
測試用讀卡機以及測試卡片，請洽詢intella業務部門申請
透過Scan2Pay API對讀卡機進行各種操作，標註為必要串接的API必須要被實作，其他可依據實際需求選擇性串接
操作 | ServiceType | 說明 | 備註 |
取得裝置清單 | 取得特店帳號下的裝置清單 | 無需卡機下即可呼叫 | |
登入 | SignOn | 悠遊卡交易需先進行登入, 登入逾30小時需重新登入 | ( ⚠ 此為必要串接) |
卡片查詢 | IdQuery | 取得卡片號碼 | |
餘額查詢 | 卡片餘額查詢 | | |
扣款 | Payment | 交易扣款 | ( ⚠ 此為必要串接) |
退款 | Refund | 交易退款 | ( ⚠ 此為必要串接) |
結帳 | 結帳 (每日關帳前呼叫進行日結) | 串接方若不進行此API呼叫，Scan2Pay系統會於交易隔日凌晨自動進行結帳 | |
訂單查詢 | OrderQuery | 查詢該卡片在Scan2Pay上的消費記錄 | |
加值 | Reserve | | 尚不開放 |
加值查詢 | ReserveOrderQuery | | 尚不開放 |
取消交易查詢 | CancelOrderQuery | | 尚不開放 |
購貨取消 | Cancel | | 尚不開放 |
現金退款 | EZCRefund | 卡片直接退款 | 特殊應用, 一般消費退款請呼叫Refund即可 |
卡片上消費記錄查詢 | EZCOrderQuery | 查詢卡片上的消費記錄 | 特殊應用, 一般消費紀錄請呼叫OrderQuery即可 |
重試交易 | 依據交易內容 | 發生交易過程中的中斷時, 需要進行重試以完成交易 | 避免因通訊或其他問題造成的錯帳 ( ⚠ 此為必要串接) |
