# 悠遊卡操作

## 說明

使用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: 此為必要串接)    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://intella.gitbook.io/scan2pay/api-specification/easycard-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.