Unipaas
基礎
Unipaas 為數位平台與市集（SaaS、零工經濟、B2B/B2C 市集）提供端到端的嵌入式支付。您可以入駐供應商（子商戶）、收款、管理帳戶（餘額）以及支付資金 — 同時控制資金流動並維持 PSD2/PCI 合規。
取得沙箱金鑰。 在 https://portal.unipaas.com/signup 建立免費測試帳戶。測試帳戶無限制且隨時可用。在入口網站中，於開發人員/金鑰區段找到您的私鑰。沙箱與正式環境憑證完全分離，不共用任何資料。
基礎 URL。
- 沙箱：
https://sandbox.unipaas.com/platform - 正式環境（Live）：
https://api.unipaas.com/platform
兩種驗證模式（詳見 references/auth.md）。
- 伺服器對伺服器：直接在 API 呼叫中將您的私鑰作為
Authorization: Bearer {{PRIVATE_KEY}}發送（建立結帳、收款、帳戶、付款、入駐）。私鑰必須保留在伺服器端。 - 兩步驟
/authorize流程（適用於用戶端平台嵌入）：您的伺服器使用scopes及（通常）vendorId將私鑰POST到/authorize，並收到一個暫時的accessToken。用戶端使用此存取令牌 — 絕不使用私鑰。
冪等性。 為避免重試時重複執行，請在 POST 請求中加入 requestId: <id> 標頭。多次套用相同的 requestId 只會產生一個結果。請求 ID 的有效期為 24 小時。
決策地圖
四種產品，三種整合層級。根據您的開發能力與 PCI 安全態勢選擇適合的層級。
| 產品 | 無程式碼 | 低負擔 | 中等負擔 |
|---|---|---|---|
| 入駐 | 託管式入駐連結 | 嵌入式 UI（unipaas.components） | 入駐 API |
| 收款 | 付款連結（入口網站） | 結帳頁面 / Web SDK | 收款 API（伺服器對伺服器） |
| 帳戶管理 | 入口網站檢視 | 帳戶/餘額元件 | 帳戶 API |
| 支付資金 | 透過入口網站手動/排程付款 | 付款表單 / 帳戶元件 | 付款 API |
指導原則：
- 想要零程式碼？ 使用付款連結、託管式入駐連結、入口網站付款。
- 想要自己的 UI 且低負擔 + 降低 PCI 範圍？ 使用結帳頁面（重新導向）、Web SDK 安全欄位、或買家 Web 嵌入；對於入駐/餘額/入口網站，使用平台嵌入。
- 想要完全控制 / 白標 / 原生應用程式？ 使用 API。收款 API（原始卡片資料）需要 PCI SAQ D。
注意：未附帶 vendorId 的交易將記錄在平台帳戶下。
用戶端結帳路徑
完整步驟請參閱 references/web-sdk.md。兩種買家付款路徑，兩者皆需透過伺服器端 POST /pay-ins/checkout 回傳的 sessionToken 進行驗證 — 不是 /authorize 存取令牌。
- 安全欄位 SDK — 載入
https://cdn.unipaas.com/unipaas.sdk.js（暴露Unipaas全域變數）。建立您自己的卡片表單，然後執行new Unipaas().initTokenize(sessionToken, fields, options)。安全欄位是此套件的功能，而非獨立的套件。 - 買家 Web 嵌入 — 載入
https://cdn.unipaas.com/embedded-ui.js，然後執行unipaas.buyerComponents(sessionToken, config)以及.create("checkout"|"card"|"digitalWallet").mount("#id")。
驗證邊界（重要）：
- 買家付款（安全欄位與買家 Web 嵌入）→ 使用來自
POST /pay-ins/checkout的sessionToken。 - 平台嵌入（
unipaas.components：餘額、發票、入駐、付款入口網站、通知）→ 使用包含 scopes 與 vendorId 的/authorize存取令牌。買家結帳不使用/authorize存取令牌。
在任何用戶端授權之後，使用伺服器端 GET /pay-ins/{authorizationId} 進行驗證；狀態必須為 CAPTURED 才算成功。
參考文件
- references/auth.md —
/authorize流程、scopes、令牌生命週期、冪等性。 - references/accept-payments.md — 收款產品、三個層級、結帳頁面、建立付款、令牌化、Webhook。
- references/web-sdk.md — 由
sessionToken驅動的兩種用戶端買家付款路徑。 - references/security.md — 金鑰處理、應保留在伺服器端的項目、PCI 涵蓋範圍。