悠遊卡操作

說明

使用intella所提供的讀卡機, 可以透過Scan2Pay API進行交易, 無須與讀卡機實體進行整合, 免除開發讀卡機控制以及送驗證的時間, 可以快速將電子票證支付整合到結帳系統中.

intella所提供的讀卡機, 使用Wifi連線到區域網路中的無線Wifi AP, 可以使用Scan2Pay App進行設定. 設定方法請參考設定說明.

測試用讀卡機以及測試卡片，請洽詢intella業務部門申請

操作

透過Scan2Pay API對讀卡機進行各種操作，標註為必要串接的API必須要被實作，其他可依據實際需求選擇性串接

操作	ServiceType	說明	備註
取得裝置清單	DeviceQuery	取得特店帳號下的裝置清單	無需卡機下即可呼叫
登入	SignOn	悠遊卡交易需先進行登入, 登入逾30小時需重新登入	( ⚠️ 此為必要串接)
卡片查詢	IdQuery	取得卡片號碼
餘額查詢	BalanceQuery	卡片餘額查詢
扣款	Payment	交易扣款	( ⚠️ 此為必要串接)
退款	Refund	交易退款	( ⚠️ 此為必要串接)
結帳	Settlement	結帳 (每日關帳前呼叫進行日結)	串接方若不進行此API呼叫，Scan2Pay系統會於交易隔日凌晨自動進行結帳
訂單查詢	OrderQuery	查詢該卡片在Scan2Pay上的消費記錄
加值	Reserve		尚不開放
加值查詢	ReserveOrderQuery		尚不開放
取消交易查詢	CancelOrderQuery		尚不開放
購貨取消	Cancel		尚不開放
現金退款	EZCRefund	卡片直接退款	特殊應用, 一般消費退款請呼叫Refund即可
卡片上消費記錄查詢	EZCOrderQuery	查詢卡片上的消費記錄	特殊應用, 一般消費紀錄請呼叫OrderQuery即可
重試交易	依據交易內容	發生交易過程中的中斷時, 需要進行重試以完成交易	避免因通訊或其他問題造成的錯帳 ( ⚠️ 此為必要串接)