Skip to main content
大多數第一週的整合問題，源自四種混淆：權杖屬於哪個帳戶、你建立的是哪種類型的應用程式、該應用程式目前的狀態、以及你正在呼叫哪個環境。本頁將逐一說明。

​
登入與帳戶

Fluz 的使用者即是一個登入：單一個人具備電子郵件、電話號碼、PIN 碼與身分驗證。一位使用者可以持有多個帳戶：
個人帳戶永遠不會被_轉換_為商業帳戶。商業帳戶是由該使用者擁有、並透過 KYB 產生的獨立帳戶。個人帳戶會與其並存。
「Personal」（於控制台中）與 CONSUMER（於 API 中）是同一概念。 錢包、消費帳戶、卡片與交易都屬於帳戶，而非使用者。相同使用者以其個人帳戶與商業帳戶行動時，會看到兩本獨立總帳。

​
每個權杖都綁定到一個帳戶

generateUserAccessToken 接受 userId 與 accountId。accountId 決定該權杖以哪個帳戶身分行動：
  • 使用者個人的 accountId 產生 CONSUMER 權杖；
  • 商業的 accountId 產生 BUSINESS 權杖。
若要查看使用者持有的所有帳戶及其各自的 ID，請使用 取得帳戶。 多數作業可接受任一種權杖，並作用於該權杖所屬的帳戶。少數作業則需要特定類型： 送出錯誤的類型會回傳 AUTH-0002，並在訊息中指明所需類型，例如 getBusinessCategories requires account type CONSUMER。請以另一個 accountId 重新簽發權杖並重試。

​
兩種應用程式

你在「開發者」區域中的點擊位置，決定了應用程式可以做什麼。
如果你要代表你自己以外的任何人建立使用者、驗證他們或發卡，你需要一個 OAuth Integration 應用程式。用 Create new app 建立的應用程式無法升級為該類型。請改用範本建立新的應用程式。

​
應用程式狀態

新建立的應用程式不會直接啟用。 應用程式由 Fluz 移轉至 ACTIVE；此步驟非自助完成。建立應用程式後，請將其名稱或 ID 提供給你的 Fluz 窗口。在此之前，凡是代表其他使用者的呼叫都會回傳：
此錯誤中的 current status: PERSONAL 指的是應用程式的狀態，而非你的帳戶類型。轉換或切換帳戶無法解決此問題。請聯絡 Fluz 啟用該應用程式。
部分功能在 ACTIVE 之上還需要逐應用程式啟用，例如 registerUser 與 VERIFY_KYC 權限範圍。每個環境的應用程式需分別啟用。

​
環境

Staging 與正式環境是相互獨立的系統： 每個環境都有獨立的使用者、帳戶、應用程式與 API 金鑰。任一環境的金鑰在另一個環境皆無法使用。當你登入 fluz.app 建立應用程式時，該應用程式即為正式應用程式，即使你只打算用它來測試。

​
綜合範例

一個為其客戶導入商業（例如為其客戶提供卡片計畫）的平台，在 Staging 環境通常會這樣運作：
  1. 你擁有一個 OAuth Integration 應用程式，歸屬於你公司帳戶，並由 Fluz 將其狀態移至 ACTIVE。
  2. 對每位客戶，你使用 registerUser 建立該個人、完成驗證，並引導他們完成 OAuth。你為他們取得的權杖為 CONSUMER。
  3. 使用該 CONSUMER 權杖呼叫 getBusinessCategories 與 registerBusiness。
  4. 當 KYB 核准該商業後，你以相同的 userId 搭配該商業的 accountId 重新簽發 BUSINESS 權杖，並為該商業發卡與進行資金操作。
請參考導入並驗證商業以取得可執行版本。