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

# Descripción general

Una **cuenta bancaria** es la fuente de fondos de menor costo y mayor recompensa en Fluz. Las cuentas bancarias se vinculan a través de **Plaid** y liquidan vía **ACH**: no tienen comisiones de procesamiento y ganan la tasa completa de cashback del comercio.

La vinculación y administración de cuentas bancarias se expone mediante un contenedor público de GraphQL. Identity-service sigue siendo el sistema de registro para los tokens de Plaid, la ingestión de cuentas, saldos, transacciones históricas y webhooks de Plaid.

<Note>
  **Las cuentas bancarias no tienen comisiones de procesamiento y ganan la tasa de cashback más alta.**

  En una oferta del comercio de 4%, un pago por ACH devuelve el 4% completo, mientras que una tarjeta de débito devuelve 3% y una tarjeta de crédito 1% después de las comisiones de procesamiento. Cuando un usuario tiene la opción, una cuenta bancaria vinculada siempre es la opción con mayor rendimiento.
</Note>

***

## Lo que puedes hacer

Todo lo siguiente se ejecuta a través de la integración con Plaid. Consulta [Vincular cuenta bancaria vía Plaid](/features/link-via-plaid) para ver los detalles completos de solicitud y respuesta.

### Vinculación

| Funcionalidad                    | Operación                                                           | Descripción                                                                       |
| -------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Crear un token de Link           | `createPlaidLinkToken`                                              | Genera el token usado para abrir Plaid Link.                                      |
| Completar una nueva vinculación  | `completePlaidLink`                                                 | Intercambia el `public_token` de Plaid e ingiere las cuentas conectadas.          |
| Reparar una conexión rota        | `createPlaidLinkToken` + `completePlaidLink` (con `platformItemId`) | Vuelve a vincular una institución previamente conectada que se ha desconectado.   |
| Adjuntar una dirección requerida | `createPlaidLinkAddress`                                            | Agrega una dirección cuando `completePlaidLink` devuelve `requiresAddress: true`. |

### Saldos y poder de gasto

| Funcionalidad                   | Operación                                             | Descripción                                                                                 |
| ------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Listar cuentas vinculadas       | `getPlaidBankAccounts`                                | Devuelve los metadatos seguros de todas las cuentas bancarias conectadas.                   |
| Leer saldos almacenados         | `getPlaidBankBalances` · `getPlaidBankAccountBalance` | Obtén el saldo almacenado más reciente entre cuentas o para una cuenta.                     |
| Leer poder de gasto             | `getPlaidBankAccountSpendPower`                       | Devuelve el poder de gasto disponible, el último saldo registrado y la actividad pendiente. |
| Actualizar un saldo             | `refreshPlaidBankAccountBalance`                      | Solicita una actualización en tiempo real con límite de frecuencia para una cuenta.         |
| Actualizar todas las conexiones | `refreshPlaidBankConnections`                         | Solicita una actualización en caché en todos los datos conectados de Plaid.                 |

### Transacciones

| Funcionalidad                   | Operación                  | Descripción                                                                                  |
| ------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------- |
| Leer historial de transacciones | `getPlaidBankTransactions` | Devuelve transacciones bancarias históricas y paginadas con detalle de comercio y categoría. |

### Administración

| Funcionalidad            | Operación                    | Descripción                                                  |
| ------------------------ | ---------------------------- | ------------------------------------------------------------ |
| Eliminar una institución | `removePlaidBankInstitution` | Desconecta una institución bancaria vinculada y sus cuentas. |

***

## Requisitos

Todas las operaciones de cuenta bancaria requieren un token de acceso de usuario de Fluz que incluya el alcance `MANAGE_PAYMENT`.

**Solo autenticación Bearer.** Los campos de Plaid no aceptan autenticación Basic. Primero obtén un token de acceso de usuario mediante el flujo de autenticación estándar y luego llama a los campos de Plaid con `Authorization: Bearer <fluz-user-access-token>`.

***

## Límites de actualización de saldo

Las actualizaciones de saldo son controladas por costo por institución de Plaid:

* **Una** actualización en tiempo real por hora
* **Seis** actualizaciones en tiempo real por día

Las llamadas realizadas dentro de la ventana de límite devuelven el saldo almacenado más reciente en lugar de activar una nueva solicitud en tiempo real.

***

## Cuentas de ahorro

<Note>
  **Vincular un inicio de sesión conecta todas las cuentas bajo ese acceso, incluidas las de ahorro.**

  La mayoría de los bancos no permiten pagos desde cuentas de ahorro. Después de vincular, los usuarios deben eliminar cualquier cuenta de ahorro desde la que no tengan intención de pagar para evitar transacciones fallidas.
</Note>

***

## Flujos no compatibles

La vinculación por microdepósitos no es compatible intencionalmente. Las nuevas vinculaciones y revinculaciones deben usar el flujo estándar de Plaid Link, que admite saldos y transacciones históricas.

***

## Seguridad

No almacenamos tokens de acceso de Plaid, tokens públicos de Plaid, detalles de coincidencia de identidad, números de cuenta bancaria ni números de ruta. Solo los metadatos seguros de la cuenta —como el nombre de la institución, los últimos cuatro dígitos, el tipo y las etiquetas ingresadas por el usuario— se exponen a través del API.

***

**¿Quieres saber más?** Habla con nuestros expertos para obtener más información o solicitar una demo.
