> For the complete documentation index, see [llms.txt](https://intella.gitbook.io/scan2pay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://intella.gitbook.io/scan2pay/api-specification/easycard-api.md).

# 悠遊卡操作

## 說明

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

intella所提供的讀卡機, 使用Wifi連線到區域網路中的無線Wifi AP,  可以使用[Scan2Pay App](https://play.google.com/store/apps/details?id=co.intella.scan2pay\&hl=zh_TW)進行設定. 設定方法請參考[設定說明](/scan2pay/appendix/reader-setup.md).

{% hint style="info" %}
測試用讀卡機以及測試卡片，請洽詢intella業務部門申請
{% endhint %}

## 操作

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

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