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

# Crear cuentas de gasto

# Descripción general

Una cuenta de saldo en efectivo del usuario es una cuenta de gasto que permite a los usuarios administrar y rastrear sus fondos disponibles dentro de la plataforma Fluz. Cada cuenta de saldo en efectivo se identifica por un apodo único y mantiene saldos separados para depósitos totales, disponibles y de por vida. Los usuarios pueden crear múltiples cuentas de saldo en efectivo (por ejemplo, "Viajes del equipo", "Billetera de operaciones", "Presupuesto de marketing") para organizar sus gastos según diferentes propósitos.

Las cuentas de saldo en efectivo son necesarias para realizar depósitos, comprar tarjetas de regalo y financiar transacciones con tarjeta virtual en la plataforma Fluz.

# Crear cuenta de saldo en efectivo del usuario

## Solicitud de ejemplo

Puedes crear una nueva cuenta de saldo en efectivo del usuario con la mutación `createUserCashBalance`. Esta mutación te permite configurar una nueva cuenta de gasto con un apodo personalizado para ayudar a organizar tus fondos. La consulta toma un objeto de entrada `CreateUserCashBalanceInput`.

```json theme={null}
{
  "query": "mutation createUserCashBalance($input: CreateUserCashBalanceInput!) { createUserCashBalance(input: $input) { userCashBalanceId totalCashBalance availableCashBalance lifetimeCashBalance nickname status createdAt }}",
  "variables": {
    "input": {
      "nickname": "Team Travel"
    }
  }
}
```

Esta mutación requiere el tipo de entrada `CreateUserCashBalanceInput`. Cualquier campo marcado con un signo de exclamación (`!`) en el esquema es obligatorio y debe incluirse en la solicitud.

| Nombre del campo | Tipo    | Descripción                                                                                                      |
| :--------------- | :------ | :--------------------------------------------------------------------------------------------------------------- |
| nickname         | String! | Un nombre personalizado para la cuenta de saldo en efectivo. Esto ayuda a identificar el propósito de la cuenta. |

## CreateUserCashBalanceInput

```json theme={null}
{
  "nickname": "Team Travel"
}
```

## Respuesta de ejemplo

La respuesta de la mutación `createUserCashBalance` incluirá los detalles de la cuenta de saldo en efectivo recién creada, incluido su identificador único e información inicial de saldo.

```json theme={null}
{
  "data": {
    "createUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "Team Travel",
      "status": "ACTIVE",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  }
}
```

### Campos de la respuesta

| Nombre del campo     | Tipo                   | Descripción                                                              |
| :------------------- | :--------------------- | :----------------------------------------------------------------------- |
| userCashBalanceId    | UUID!                  | Identificador único de la cuenta de saldo en efectivo                    |
| totalCashBalance     | String!                | Saldo total en efectivo en la cuenta (inicia en 0)                       |
| availableCashBalance | String!                | Saldo en efectivo disponible para uso inmediato (inicia en 0)            |
| lifetimeCashBalance  | String!                | Total acumulado de todos los fondos depositados alguna vez (inicia en 0) |
| nickname             | String                 | El nombre personalizado asignado a la cuenta                             |
| status               | UserCashBalanceStatus! | Estado actual de la cuenta (ACTIVE, CLOSED o SUSPENDED)                  |
| createdAt            | DateTime!              | Marca de tiempo cuando se creó la cuenta                                 |

> ❗️ Se requiere autorización
>
> Esta mutación requiere el alcance `MANAGE_PAYMENT`. Asegúrate de que tu token de acceso tenga otorgado este alcance antes de intentar crear una cuenta de saldo en efectivo.

<StickyContactSalesBanner />