---
description: Scan2Pay API說明
---

# API規格說明

## API功能

Scan2Pay API 包括

| 功能                                                 | ServiceType      | 備註                       |
| -------------------------------------------------- | ---------------- | ------------------------ |
| [消費者主掃](api-specification/customer-scan)           | OLPay            | 用來取得URL產生QR Code供消費者掃描交易 |
| [消費者被掃](api-specification/merchant-scan)           | Micropay         | 掃描消費者QR Code進行交易         |
| [信用卡授權](api-specification/credit-card)             | Payment          | 使用信用卡授權交易                |
| [退款](api-specification/refund)                     | Refund           | 退款                       |
| [單筆交易查詢](api-specification/single-order-query)     | SingleOrderQuery | 依據訂單編號查詢單筆交易             |
| [多筆交易查詢](api-specification/multi-order-query)      | OrderQuery       | 依據日期區間查詢交易               |
| [新版多筆交易查詢](api-specification/multi-order-query1.1) | OrderQuery1.1    | 依據日期區間查詢交易               |

## 消費者主掃

消費者主掃, 是指收款端透過呼叫消費者主掃API, 取得一個URL, 並將期顯示為一個QR Code, 讓消費者使用手機掃描.

消費者掃描QR Code後, 開啟支付頁面, 選擇所要使用的支付方式後, 在對應的App中完成支付.

收款端透過輪詢單筆交易查詢API, 或是[提供接收交易結果通知的API](api-callback), 來獲取消費者支付結果, 完成交易.

{% hint style="warning" %}
並非每種支付方式都支援消費者主掃的交易方式
{% endhint %}

{% content-ref url="api-specification/customer-scan" %}
[customer-scan](api-specification/customer-scan)
{% endcontent-ref %}

## 消費者被掃

消費者被掃,  是指收款端使用掃描槍或是相機, 掃描消費手出示的付款QR Code,   然後呼叫消費者被掃API, 完成交易.

{% hint style="warning" %}
並非每種支付方式都支援消費者被掃的交易方式
{% endhint %}

{% content-ref url="api-specification/merchant-scan" %}
[merchant-scan](api-specification/merchant-scan)
{% endcontent-ref %}

## 信用卡授權

收款端取得消費者的信用卡資料, 然後呼叫信用卡授權API, 進行信用卡授權交易.

{% hint style="info" %}
測試信用卡交易, 請洽intella取得測試信用卡卡號
{% endhint %}

{% content-ref url="api-specification/credit-card" %}
[credit-card](api-specification/credit-card)
{% endcontent-ref %}

## 悠遊卡操作

透過悠遊卡操作API, 收款端可以直接對讀卡機進行扣款, 退款等操作, 進行交易.

{% hint style="info" %}
悠遊卡操作API需搭配intella所提供的讀卡機, 該讀卡機使用WiFi連線到網際網路, 以及intella server
{% endhint %}

{% content-ref url="api-specification/easycard-api" %}
[easycard-api](api-specification/easycard-api)
{% endcontent-ref %}

## 退款

對於已經成功的交易, 可以透過退款API, 將指定的交易訂單進行退款.

{% hint style="info" %}
退款的實際時間, 需視各支付機構的規定.
{% endhint %}

{% content-ref url="api-specification/refund" %}
[refund](api-specification/refund)
{% endcontent-ref %}

## 單筆交易查詢

單筆交易查詢API提供查詢單筆交易的交易結果, 以及訂單狀態

{% content-ref url="api-specification/single-order-query" %}
[single-order-query](api-specification/single-order-query)
{% endcontent-ref %}

## 多筆交易查詢

查詢指定的時間內的交易,  可以透過呼叫多筆交易查詢API取得.

{% hint style="info" %}
查詢的交易時間以日為單位
{% endhint %}

{% content-ref url="api-specification/multi-order-query" %}
[multi-order-query](api-specification/multi-order-query)
{% endcontent-ref %}

