串接流程（必讀）
一、串接方式說明
為了保證特店高轉化率，高安全性，我們在交易流程中採用了 Web JS SDK + API 的方案。並在此基礎上整合了所有付款方式流程，讓您一次串接，後續無憂； 因為 SHOPLINE Payments 支援 Web JS SDK，因此可以支援內嵌 SDK 做法的 PC 網頁或行動裝置網頁。
功能概覽
| 功能類別 | 功能名稱 | 功能描述 |
|---|---|---|
| 一般交易 | 建立交易單 | 通過此API進行所有付款方式的交易單建立 |
| 請款 | 通過此API對信用卡付款方式的授權交易進行請款動作，扣除授權鎖定的金額額度 | |
| 取消授權 | 通過此API對信用卡付款方式的授權交易進行取消授權動作，釋放授權鎖定的金額額度。於請款前方可進行取消授權 | |
| 退款 | 通過此API對所有付款方式的成功交易進行退款，退還款項給顧客。於請款後方可進行退款 | |
| 綁卡/快捷/定期交易 | 會員 | 通過會員相關API進行會員的增/刪/改/查動作 |
| 付款工具 | 通過付款工具相關API進行會員下的付款工具刪/改/查動作 | |
| 平台Connect | 平台Connect | 通過此API，平台可與已註冊SHOPLINE Payments的特店進行授權，特店授權通過後，平台方可處理特店的交易/請款/取消授權/退款/會員/付款工具 |
二、串接步驟介紹
為了確保串接效率，保障串接質量，特店串接前請務必仔細閱讀此串接流程，依照規格所述流程串接。
串接流程主要分為以下幾個步驟：
1. 特店申請
- 特店與 SHOPLINE Payments 業務窗口聯繫，進行網站特店註冊，同時填寫申請資訊，提交審核
- 審核通過後，特店向 SHOPLINE Payments 串接窗口申請，產生以下正式環境技術串接金鑰
| 金鑰類型 | 金鑰用途 |
|---|---|
| apiKey | 用於 Server-api 串接認證 |
| clientKey | 用於 SDK 串接認證 |
| signKey | 用於 Event 通知串接認證 |
2. 技術串接及申請
SHOPLINE Payments 提供 SDK+API 的技術串接，特店網站需要將 SDK 整合到結帳頁，配合 Server-API 完成結帳頁收款； 主要分為以下重點步驟：
SHOPLINE Payments 提供以下收款業務場景串接：
- 一般收款，支援信用卡、信用卡分期、ATM銀行轉帳、街口支付、中租 zingla 銀角零卡分期、LINE Pay等收款功能；一般付款串接
- 綁卡/快捷/定期收款，支援特店提供給顧客綁定常用信用卡進行快速、定期扣款等收款功能；綁卡/快捷/定期付款串接
3.沙盒環境串接
特店技術人員依據串接規格完成 SDK 及 Server-API 整合後，可串接 SHOPLINE Payments 沙盒環境進行聯調驗證
- 串接前，可聯絡 SHOPLINE Payments 業務窗口建立串接群組，以便溝通與解決串接問題
- 沙盒環境整合資源可參照：沙盒環境串接資源
- 沙盒環境需完成付款、退款、Event 通知等功能串接驗證，綁卡/快捷場景需完成會員及付款工具功能驗證
- 沙盒環境驗證完成後，進行正式環境串接
4. 正式環境驗證
特店技術人員在完成沙盒環境串接驗證後，可安排進行正式環境串接，正式環境串接後，即可使用 SHOPLINE Payments 進行收款
- 設定 apiKey, clientKey, signKey, 此為申請階段網站後台產生的金鑰
- webhook 地址设置: 通知[Event]
- 正式環境驗證付款、退款、Event 通知等功能