> 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/master.md).

# Scan2Pay API

## 眾多的支付方式

要使用第三方支付, 信用卡支付, 電子票卷支付, 會涉及到與眾多支付供應商的API串接, 除了各家API不同, 需要耗費大量開發與測試的時間, 各家支付不統一的方式與流程也增加串接與開發上的困難度.

## 統一的API接口, 快速串接開發

Scan2Pay提供統一的第三方支付模式, 並將與各家支付串接的部分在Server端處理掉, 客戶僅需要呼叫Scan2Pay API, 即可完成與各家支付的串接, 可以在短短幾天內就完成引入第三方支付的開發.

{% hint style="info" %}
除開發外, 要使用第三方支付需要申請各家第三方支付的帳號, intella可協助客戶申請
{% endhint %}

## 多元支付

Scan2Pay 目前支援台灣市場上眾多的支付方式, 包括:

* 第三方支付
* 信用卡授權
* 電子票證支付

## 適用應用

Scan2Pay適用的應用包括

* POS機台
* 自動販賣機 / Kiosk
* 電子商務 / 線上交易

## 開始使用Scan2Pay API

1. 請洽詢intella業務窗口,  申請使用Scan2Pay API, 並取得相關資料(下方說明)
2. 依據所使用的平台以及程式語言, 下載對應的[SDK](https://github.com/intella-co)
3. 開始進行API串接

{% hint style="info" %}
Scan2Pay API串接相關資料包括

* 特店測試帳號密碼
* API伺服器的位址(URL)
* API伺服器的金鑰 (RSA public key, AES IV)
  {% endhint %}

{% hint style="info" %}
若有電子票證讀卡機(悠遊卡機)測試機的需求, 也請聯繫intella業務窗口
{% endhint %}

{% hint style="warning" %}
請注意, Scan2Pay系統的密碼有三組:

* **特店密碼**: 用來登入特店後台系統，進行帳務查詢
* **交易密碼**: 用來呼叫API的必須欄位
* **退款密碼**: 用來呼叫退款API時的額外貴款密碼欄位

:warning: 特店後台系統可以進行**特店密碼**以及**退款密碼**的修改，若退款密碼修改後，呼叫退款API時，務必同步使用更新後的退款密碼，否則會造成退款失敗
{% endhint %}