先決條件
- 一個包含測試環境應用程式的 Fluz 帳戶 — 任何快速上手的步驟 1–2，或參見準備你的帳戶與API 憑證。
- 一個已設定 OAuth 的應用程式：
client_id、client_secret，以及已註冊的redirect_uri— 參見建立 OAuth App與設定 OAuth App。 - 請將請求送至沙盒 — 沒有真實金錢、也沒有真實個資。參見測試與正式環境。
完整流程
註冊客戶
使用
registerUser 佈建完整使用者 — 帳戶、餘額與推薦功能 — 並以你的應用程式權杖進行驗證。讓客戶完成 OAuth 授權
客戶透過前往代管的授權頁來授權你的應用程式。使用你的 OAuth 設定與整合所需的範圍來建立 URL：
Authorization URL
scopes以空白分隔（URL 需編碼為%20），且必須是你應用程式已啟用範圍的子集合 — 未知的範圍會被靜默忽略。state會原封不動回傳 — 用來將重導與你的工作階段對應。
redirect_uri，並附帶 ?code=...&state=...。該 code 僅能使用一次 — 請於伺服端擷取。完整參數參考：參見面向客戶的 OAuth 授權流程。以授權碼兌換客戶權杖
以授權碼兌換作用於客戶範圍的
accessToken（以及 refreshToken）。此呼叫使用基本驗證：client_id:client_secret 的 base64。redirect_uri 必須與授權步驟完全相同。請儲存 refreshToken 並在 accessTokenExpiresAt 之前輪替 — 參見刷新 OAuth 存取權杖。驗證客戶身分（KYC）
欲進行金流操作，需要完成身分驗證。請以客戶的權杖呼叫
verifyUserInformation — 權杖決定要驗證的是誰。在測試環境中，以下測試身分會一律回傳 APPROVED：在其帳戶上操作 — 證明連線成功
重點來了：以客戶的權杖執行任何 Fluz 操作，將會在該客戶帳戶上執行。收到
createVirtualCard 就是 createVirtualCard — 並無獨立的平台 API。ACTIVE 卡片代表閉環完成：已註冊 → 已連結 → 已驗證 → 可操作。客戶會透過權杖在你的系統中可見；他們不會獲得對「你的」帳戶的任何存取，而你只持有他們所授予的範圍。大功告成 🎉
你已端到端導入並連結了一位客戶。接下來：建置平台
完整的平台架構 — 權杖路徑、能力與模式。
核准與請求
讓已連結使用者提出請求，由擁有者核准。
外部參考 ID
以你的自有 ID 而非 Fluz 帳戶 ID 來識別客戶。
企業註冊與 KYB
不只導入個人，也能導入企業。
想了解更多嗎？ 與我們聯繫：support@fluz.app 以與專家對談或預約示範。