> ## 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 de gasto** es una cuenta de saldo en efectivo dentro de Fluz que un usuario utiliza para guardar, organizar y rastrear fondos. Cada cuenta tiene su propio apodo, por lo que un usuario puede separar los gastos por propósito — por ejemplo, "Viajes del equipo", "Billetera de operaciones" o "Presupuesto de marketing" — y cada cuenta mantiene sus propios saldos en curso.

Las cuentas de gasto son la billetera de la cual se nutre todo lo demás: contienen los fondos utilizados para comprar tarjetas de regalo, financiar transacciones con tarjetas virtuales y recibir depósitos y transferencias.

<Note>
  **"Cuenta de gasto" y "cuenta de saldo en efectivo" son lo mismo.**

  En la API, una cuenta de gasto está representada por el tipo `UserCashBalance`, y las operaciones se nombran `...UserCashBalance` (p. ej., `createUserCashBalance`). En esta página usamos "cuenta de gasto" en todo momento.
</Note>

***

## Saldos

Cada cuenta de gasto registra tres saldos, todos devueltos como strings:

| Balance        | Campo                  | Descripción                                                                        |
| -------------- | ---------------------- | ---------------------------------------------------------------------------------- |
| **Total**      | `totalCashBalance`     | El saldo total actualmente mantenido en la cuenta.                                 |
| **Disponible** | `availableCashBalance` | La porción disponible para gastar de inmediato.                                    |
| **Acumulado**  | `lifetimeCashBalance`  | El total acumulado de todos los fondos que alguna vez se depositaron en la cuenta. |

Un usuario puede tener **múltiples** cuentas de gasto, y una se marca como la **predeterminada** (`isDefault: true`).

***

## Qué puedes hacer

| Acción                                                       | Query / Mutación                                 | Alcance          | Descripción                                                                                 |
| ------------------------------------------------------------ | ------------------------------------------------ | ---------------- | ------------------------------------------------------------------------------------------- |
| [Crear una cuenta de gasto](/features/create-spend-accounts) | `createUserCashBalance`                          | `MANAGE_PAYMENT` | Abrir una nueva cuenta de gasto con un apodo personalizado.                                 |
| [Obtener cuentas de gasto](/features/get-spend-accounts)     | `getUserCashBalances` · `getUserCashBalanceById` | `LIST_PAYMENT`   | Listar todas las cuentas de gasto (con filtrado y paginación) o recuperar una por ID.       |
| [Editar una cuenta de gasto](/features/edit-spend-accounts)  | `updateUserCashBalance`                          | `MANAGE_PAYMENT` | Renombrar una cuenta de gasto (apodo, 2–100 caracteres).                                    |
| [Cerrar una cuenta de gasto](/features/close-spend-accounts) | `closeUserCashBalance`                           | `MANAGE_PAYMENT` | Cerrar una cuenta, mover su saldo restante y manejar cualquier tarjeta virtual dependiente. |

***

## Ciclo de vida de la cuenta

Una cuenta de gasto pasa por un pequeño conjunto de estados (`UserCashBalanceStatus`): típicamente `ACTIVE`, y `CLOSED` una vez cerrada.

Cerrar una cuenta es más que un cambio de estado. Cuando cierras una cuenta de gasto con un saldo disponible restante, ese saldo debe trasladarse a otra cuenta de gasto. Si alguna tarjeta virtual está financiada por la cuenta que se va a cerrar, debes reasignarla a una nueva fuente de fondos o bloquearla como parte de la misma solicitud.

<Note>
  **Cerrar una cuenta requiere que resuelvas su saldo y sus tarjetas dependientes.**

  Si la cuenta aún tiene un saldo disponible, proporciona `transferUserCashBalanceId` para moverlo. Si hay tarjetas virtuales vinculadas a la cuenta, proporciona `newFundingSource` para reasignarlas o `lockAllVirtualCards` para bloquearlas. Consulta [Cerrar cuentas de gasto](/features/close-spend-accounts) para la referencia completa de la entrada.
</Note>

***

## Cómo encajan las cuentas de gasto

Las cuentas de gasto están en el centro de la billetera de un usuario:

* **Fondearlas** con [Depositar fondos](/features/deposit-from-external-accounts) o mover dinero entre ellas con [Transferencias internas](/features/transfer-between-spend-accounts).
* **Gastar desde ellas** en [tarjetas de regalo](/purchase-gift-card) y [tarjetas virtuales](/features/virtual-cards).
* **Consultar saldos** en cualquier momento con [Consultar saldo de la cuenta](/check-account-balance) o las consultas de cuenta de gasto anteriores.

***

## Requisitos

Listar cuentas de gasto requiere el alcance `LIST_PAYMENT`. Crear, editar y cerrar cuentas de gasto requiere el alcance `MANAGE_PAYMENT`. Asegúrate de que el token de acceso del usuario incluya el alcance correcto antes de llamar estas operaciones.

***

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