> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Fluz API 簡介

Fluz API 讓你可將資金流動直接嵌入到你的平台、程式或工作流程中——入金、錢包、消費、獎勵與撥款——透過單一整合與統一總帳完成。Fluz 已在卡片、錢包、入金、出金與帳單支付等通道處理超過 \$5 billion。

本概觀說明你可以建構的內容、API 的高階運作方式，以及達成第一次成功呼叫的最快路徑。我們建議在深入指南前先快速瀏覽。

<Tip>
  📘 **使用 AI 工具嗎？** 將你的助理指向我們可機器讀取的文件索引 — [llms.txt](/llms.txt) — 一份完整且永遠最新的所有指南、範例與變更日誌地圖。你也可以透過 MCP 於 [/mcp](/mcp) 連線。
</Tip>

## 五種資金移動方式

API 對應至 Fluz 的核心資金移動解決方案，你可以搭配使用或各自獨立使用：

* **入金（Pay-Ins）** — 透過可設定的存入與資金補充流程，支援多種付款方式（銀行、卡片、PayPal、錢包餘額）、自動結算與對帳，以及即時餘額更新，將資金帶入你的平台。
* **錢包（Wallets）** — 開立專用的消費帳戶以管理資金的持有與使用，具備用戶開戶與身分驗證、虛擬帳號與通用總帳支援。
* **消費（Spend）** — 在你的產品內發行可被網路受理、具品牌化的虛擬卡，提供用戶可控的餘額、商家與類別消費控管，以及互動與忠誠度功能。
* **獎勵（Rewards）** — 透過數位禮品卡與預付卡即時發放獎勵，支援彈性的資金來源與即時追蹤。
* **撥款（Disbursement）** — 以偏好付款方式快速、安全地出款，提供開放式循環出款選項、內嵌出款流程與內建法遵。

## 你可以打造什麼

API 為數個旗艦型使用模式而設計：

**內嵌錢包（Embedded wallets）** — 在你的平台與客戶之間雙向移動資金。一次性的 OAuth 連線會建立持久性的錢包對錢包連結，因此你可以用單一 API 呼叫進行出款，讓客戶透過虛擬卡、銀行轉帳、帳單代繳或禮品卡進行消費，並以商家層級資料在即時總帳中追蹤每一筆移動，同時也能接受入金——全部都在一個整合中完成。參見 [embedded wallets solution](https://fluz.app/us/embedded-wallets/)。

**開放式循環預付卡（Open-loop prepaid cards）** — 為獎勵、表揚與撥款發行可設定的 Visa 與 Mastercard 卡片。卡片可為虛擬或實體、一次性加值或可重複加值、可加入 Apple/Google Wallet、可依類別或商家限制，並可大量訂購（一次最多 10,000 張），支援白標或聯合品牌卡面。參見 [open loop cards](https://fluz.app/us/open-loop/)。

這些能力驅動了真實世界的計畫，例如員工表揚、銷售 SPIFF、顧客忠誠、推薦獎勵、接案工作者與創作者出款、保險理賠撥款、市調獎勵，以及用戶消費/零用金計畫。

此外，API 也涵蓋禮品卡採購（上千品牌目錄，具優惠比較、最佳優惠查詢與庫存檢查）、授權使用者、交易報表與註記、內嵌 JavaScript 小工具與 webhooks，以及含 KYC/KYB 驗證的客戶註冊。

## API 如何運作

在你的第一次請求前，有幾件事要先了解：

* **這是一個 GraphQL API。** 你會對單一端點送出 queries 與 mutations，而不是呼叫多個 REST 路由。測試用端點為 `https://transactional-graph.staging.fluzapp.com/api/v1/graphql`。
* **驗證是兩步驟。** 你使用 API key（Basic auth）進行驗證以產生短期有效的 **User Access Token**，該權杖承載作業所需的特定權限 **scopes**（例如，`CREATE_VIRTUALCARD`）。你在後續請求中以 Bearer token 傳遞該權杖。請參見 [Authentication & Authorization Guide](/concepts/authentication)。
* **在上線前先測試。** 完整的 [staging environment](/concepts/environments) 讓你可使用沙盒金鑰、測試銀行帳戶與測試卡片優惠進行開發，再切換至正式環境。
* **請求具遞送冪等性。** 使用 [idempotency keys](/concepts/idempotency) 可安全重試請求而不會重複購買或轉帳。
* **多種上線路徑。** 除了原生 API，你也可以使用低/無程式碼的小工具與可即插即用的程式碼片段、既有整合的可插入式 API 轉接器，以及以 OAuth 保護的 KYB/KYC「Comply」小工具自動化入駐流程。

## 建構於受監管且安全的基礎架構之上

Fluz 對每一筆資金移動採用銀行等級控管：符合 **SOC 2 Type II** 與 **PCI DSS**，持續 24/7 反詐監控，並內建 KYC/KYB。消費帳戶資金由受 FDIC 保險之銀行合作夥伴託管，在特定條件下可享有最高 \$10,000,000 的穿透式存款保險保障。\*

## 開始使用

1. [**準備你的帳戶**](/get-started/prepare-accounts) — 建立你的 Fluz 帳戶並註冊第一個應用程式。
2. [**取得你的 API 憑證**](/get-started/api-credentials) 並 [**產生 User Access Token**](/recipes/generate-user-access-token)。
3. [**執行你的第一個 API 操作**](/get-started/first-api-call) — 存入資金、瀏覽商家並購買你的第一張禮品卡。

接著，探索這些指南：[virtual cards](/features/virtual-cards)、[wallets & transfers](/features/create-spend-accounts) 與 [embedded widgets](/developers/widgets)，或直接前往 [API Reference](/api-reference/overview)。

***

**想了解更多？** 聯絡我們：[humans@fluz.app](mailto:humans@fluz.app) 與專家對談或申請示範。

***

> \**FDIC 聲明：Fluz 是一家金融科技公司，而非受 FDIC 保險的銀行。銀行服務由我們受 FDIC 保險之銀行合作夥伴提供。FDIC 保險僅涵蓋受 FDIC 保險之銀行的倒閉風險。透過我們與銀行合作夥伴直接合作進行存款配置且實際存入該等銀行的客戶資金，在特定條件已被滿足時，可享有最高 \$10,000,000.00 的穿透式 FDIC 保險保障。但存在無法符合條件而導致 FDIC 保險不可用的風險。在此情況下，若存放資金之受保存款機構倒閉，資金可能無法獲得完整保障。*

從[這裡](/get-started/prepare-accounts)開始。