悠遊卡操作

說明

使用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即可

重試交易

依據交易內容

發生交易過程中的中斷時, 需要進行重試以完成交易

避免因通訊或其他問題造成的錯帳 ( 此為必要串接)