> ## 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.

# Introducción a la API de Fluz

La API de Fluz te permite integrar el movimiento de dinero directamente en tu plataforma, programa o flujo de trabajo — ingresos, billeteras, gasto, recompensas y desembolsos — mediante una única integración con un libro mayor unificado. Fluz ha procesado más de \$5 mil millones en tarjetas, billeteras, ingresos, pagos y pagos de facturas.

Este panorama general cubre qué puedes construir, cómo funciona la API a alto nivel y el camino más rápido hacia tu primera llamada exitosa. Recomendamos hojearlo antes de profundizar en las guías.

<Tip>
  📘 **¿Usas herramientas de IA?** Indica a tu asistente nuestro índice legible por máquina — [llms.txt](/llms.txt) — un mapa completo y siempre actualizado de cada guía, receta y entrada del changelog. También puedes conectarte vía MCP en [/mcp](/mcp).
</Tip>

## Cinco formas en que se mueve el dinero

La API se alinea con las soluciones centrales de movimiento de dinero de Fluz, que puedes usar juntas o por separado:

* **Ingresos (Pay-Ins)** — Ingresa fondos a tu plataforma mediante flujos de depósito y fondeo configurables, con soporte para múltiples métodos de pago (banco, tarjeta, PayPal, saldo de billetera), liquidación y conciliación automatizadas, y actualizaciones de saldo en tiempo real.
* **Billeteras** — Abre cuentas de gasto dedicadas que gobiernan cómo se mantienen y usan los fondos, respaldadas por incorporación de usuarios y verificación de identidad, números de cuenta virtuales y un libro mayor universal.
* **Gasto (Spend)** — Emite tarjetas virtuales de marca aceptadas por la red, integradas en tu producto, con saldos controlados por el usuario, controles de gasto por comercio y categoría, y funciones de engagement y lealtad.
* **Recompensas** — Distribuye incentivos mediante tarjetas de regalo digitales y tarjetas prepagadas con entrega instantánea, fuentes de fondos flexibles y seguimiento en tiempo real.
* **Desembolso** — Realiza pagos rápidos y seguros en los métodos de pago preferidos, con opciones de pago open-loop, flujos de pago embebidos y cumplimiento integrado.

## Qué puedes construir

Algunos patrones principales para los que está diseñada la API:

**Billeteras embebidas** — Mueve dinero en ambas direcciones entre tu plataforma y tus clientes. Una conexión OAuth de una sola vez crea un vínculo persistente billetera a billetera, para que puedas pagar con una sola llamada a la API, permitir que los clientes gasten mediante tarjeta virtual, transferencia bancaria, pago de facturas o tarjetas de regalo, rastrear cada movimiento en un libro mayor en tiempo real con datos a nivel de comercio y aceptar nuevamente ingresos, todo mediante una sola integración. Consulta la [solución de billeteras embebidas](https://fluz.app/us/embedded-wallets/).

**Tarjetas prepagadas open-loop** — Emite tarjetas Visa y Mastercard configurables para incentivos, reconocimiento y desembolsos. Las tarjetas pueden ser virtuales o físicas, de una sola carga o recargables, listas para Apple/Google Wallet, restringidas por categoría o comercio, y ordenadas al por mayor (hasta 10,000 a la vez) con arte de tarjeta de marca blanca o co-marca. Consulta [open loop cards](https://fluz.app/us/open-loop/).

Estas impulsan programas del mundo real como reconocimiento de empleados, SPIFFs de ventas, lealtad de clientes, recompensas por referidos, pagos a trabajadores gig y creadores, pagos de reclamaciones de seguros, incentivos de investigación de mercado y programas de gasto/asignación para usuarios.

Además de esto, la API también abarca la compra de tarjetas de regalo (un catálogo de miles de marcas con comparación de ofertas, búsqueda de mejor oferta y verificación de stock), usuarios autorizados, reporte y anotación de transacciones, widgets de JavaScript embebidos con webhooks y registro de clientes con verificación KYC/KYB.

## Cómo funciona la API

Algunas cosas que debes saber antes de tu primera solicitud:

* **Es una API GraphQL.** Envías queries y mutations a un solo endpoint en lugar de llamar rutas REST. El endpoint de staging es `https://transactional-graph.staging.fluzapp.com/api/v1/graphql`.
* **La autenticación es de dos pasos.** Te autenticas con tu API key (Basic auth) para generar un **User Access Token** de corta duración, que porta los **scopes** de permiso específicos que requiere una operación (por ejemplo, `CREATE_VIRTUALCARD`). Pasas ese token como Bearer token en solicitudes posteriores. Consulta la [Guía de Autenticación y Autorización](/concepts/authentication).
* **Prueba antes de salir a producción.** Un [entorno de staging](/concepts/environments) completo te permite desarrollar con llaves de sandbox, cuentas bancarias de prueba y ofertas de tarjetas de prueba antes de cambiar a producción.
* **Las solicitudes son idempotentes.** Usa [claves de idempotencia](/concepts/idempotency) para reintentar solicitudes de forma segura sin duplicar compras o transferencias.
* **Múltiples caminos para lanzar.** Más allá de la API pura, puedes usar widgets de bajo/sin código y snippets plug-and-play, adaptadores de API de fácil integración para conexiones existentes y un widget “Comply” de KYB/KYC asegurado con OAuth para automatizar la incorporación.

## Construido sobre infraestructura regulada y segura

Fluz aplica controles de nivel bancario en cada movimiento de dinero: cumplimiento con **SOC 2 Tipo II** y **PCI DSS**, monitoreo continuo de fraude 24/7 e inclusión de KYC/KYB. Los fondos de las cuentas de gasto se mantienen en bancos socios asegurados por la FDIC, con cobertura de seguro de depósitos con pass-through disponible hasta \$10,000,000 bajo ciertas condiciones.\*

## Comienza

1. [**Prepara tus cuentas**](/get-started/prepare-accounts) — crea tu cuenta de Fluz y registra tu primera aplicación.
2. [**Obtén tus credenciales de API**](/get-started/api-credentials) y [**genera un User Access Token**](/recipes/generate-user-access-token).
3. [**Realiza tus primeras acciones en la API**](/get-started/first-api-call) — deposita fondos, explora comercios y compra tu primera tarjeta de regalo.

A partir de ahí, explora las guías de [tarjetas virtuales](/features/virtual-cards), [billeteras y transferencias](/features/create-spend-accounts) y [widgets embebidos](/developers/widgets), o ve a la [Referencia de la API](/api-reference/overview).

***

¿Quieres saber más? Contáctanos en [humans@fluz.app](mailto:humans@fluz.app) para hablar con nuestros expertos o solicitar una demo.

***

> \**Divulgación de la FDIC: Fluz es una empresa de tecnología financiera, no un banco asegurado por la FDIC. Los servicios bancarios son proporcionados por nuestros bancos socios asegurados por la FDIC. El seguro de la FDIC solo cubre la quiebra de un banco asegurado por la FDIC. El seguro de la FDIC de hasta \$10,000,000.00 está disponible sobre los fondos de los clientes mediante seguro pass-through proporcionado por bancos socios con los que tenemos una relación directa para la colocación de depósitos y en los cuales se depositan los fondos de los clientes, pero solo si se han cumplido ciertas condiciones. Puede existir el riesgo de que el seguro de la FDIC no esté disponible porque no se hayan satisfecho las condiciones. En tales casos, los fondos pueden no estar totalmente asegurados en el evento de que la institución de depósito asegurada donde se han depositado los fondos llegara a fallar.*

Comienza [aquí](/get-started/prepare-accounts).
