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