> ## 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 十亿的交易。

本概览介绍你可以构建的内容、API 的高层工作方式，以及实现首次成功调用的最快路径。建议在深入阅读各指南前先快速浏览。

<Tip>
  📘 **在使用 AI 工具？** 将你的助理指向我们的机器可读文档索引 —— [llms.txt](/llms.txt) —— 一份完整、始终最新的所有指南、范例和变更日志的地图。你也可以通过 MCP 连接至 [/mcp](/mcp)。
</Tip>

## 五种资金流动方式

该 API 对应 Fluz 的核心资金流动解决方案，你可以组合使用或单独使用：

* **入金（Pay-Ins）** — 通过可配置的存入与资金流转流程将资金带入你的平台，支持多种支付方式（银行、卡片、PayPal、钱包余额）、自动结算与对账，以及实时余额更新。
* **钱包（Wallets）** — 开立专用的消费账户，以管理资金的持有与使用，具备用户开户与身份验证、虚拟账户号以及通用总账等能力。
* **消费（Spend）** — 在你的产品中发行网络受理的品牌虚拟卡，具备用户可控余额、商户与品类消费控制，以及互动与忠诚度功能。
* **奖励（Rewards）** — 通过数字礼品卡和预付卡分发激励，支持灵活的资金来源与实时跟踪，且可即时发放。
* **拨款（Disbursement）** — 以用户偏好的支付方式快速、安全地发放款项，提供开放式支付选项、内嵌的拨款流程与内建合规能力。

## 你可以构建什么

该 API 专为以下旗舰模式而设计：

**内嵌钱包** — 在你的平台与客户之间实现双向资金流动。一次性的 OAuth 连接即可创建持久的钱包到钱包链接，因此你可以通过一次 API 调用完成付款，让客户通过虚拟卡、银行转账、账单支付或礼品卡进行消费；以商户级数据在实时总账中追踪每一笔资金流动，并接收入金——全部通过一次集成完成。参见 [embedded wallets solution](https://fluz.app/us/embedded-wallets/)。

**开放式预付卡** — 为激励、表彰与拨款发行可配置的 Visa 与 Mastercard 卡片。卡片可为虚拟或实体、一次充值或可重复充值、可添加至 Apple/Google Wallet、可按品类或商户限制，并可批量订购（单次最高 10,000 张），支持白标或联合品牌卡面。参见 [open loop cards](https://fluz.app/us/open-loop/)。

这些能力为真实世界的项目赋能，如员工表彰、销售激励（SPIFF）、客户忠诚、推荐奖励、零工与创作者拨款、保险理赔拨款、市场调研激励，以及用户消费/零用金项目。

除此之外，API 还涵盖礼品卡采购（数千品牌目录，支持优惠对比、最佳优惠查询与库存检查）、授权用户、交易报告与注释、带有 webhooks 的内嵌 JavaScript 小部件，以及带 KYC/KYB 验证的客户注册。

## API 如何工作

在发出你的第一个请求前，需要了解的几点：

* **这是一个 GraphQL API。** 你向单一端点发送查询与变更，而非调用 REST 路由。预发布端点为 `https://transactional-graph.staging.fluzapp.com/api/v1/graphql`。
* **认证是两步式的。** 你使用 API 密钥（Basic 认证）来生成短期有效的 **User Access Token**，其中包含操作所需的特定权限 **scopes**（例如 `CREATE_VIRTUALCARD`）。你在后续请求中以 Bearer 令牌方式传递该令牌。参见 [Authentication & Authorization Guide](/concepts/authentication)。
* **上线前先测试。** 完整的[预发布环境](/concepts/environments)允许你基于沙盒密钥进行构建、使用测试银行账户与测试卡片优惠，然后再切换到生产环境。
* **请求是幂等的。** 使用[幂等键](/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) —— 存入资金、浏览商户并购买你的第一张礼品卡。

接下来，探索关于[虚拟卡](/features/virtual-cards)、[钱包与转账](/features/create-spend-accounts)以及[内嵌小部件](/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)开始。