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

# Consultar saldo de cuenta

## Saldos de cuenta

Tu cuenta de Fluz puede tener hasta cuatro saldos diferentes:

1. **Saldo de recompensas**: Un saldo retirable que contiene tu cashback disponible y recompensas de bono.
2. **Saldo en efectivo (Cuenta de gasto)**: Saldos retirables que puedes usar para financiar tus compras de tarjetas de regalo y tarjetas virtuales, entre otros usos.
3. **Saldo de prepago de Fluz**: Un saldo no retirable que puedes usar para compras de tarjetas de regalo y tarjetas virtuales.
4. **Saldo de reserva**: Un saldo mantenido en Fluz para cubrir cualquier transacción que no se liquide, asegurando que tu cuenta se mantenga en buen estado.

Para ver tus saldos actuales puedes usar la `getWallet` [consulta](https://storage.googleapis.com/fluz-public-docs/api-reference.html#query-getWallet). Esto puede ayudarte a determinar cuánto quieres depositar o aplicar a una compra de tarjeta de regalo. La suma de estos saldos conforma tu “saldo disponible de Fluz”, que determina el monto total que puedes usar para financiar un pago en Fluz.

## Cuentas de saldo en efectivo del usuario (Cuentas de gasto)

Puedes acceder a información detallada sobre cuentas individuales de saldo en efectivo a través del campo `userCashBalances`. Monitoreo del estado de la cuenta y fechas de creación

El campo `userCashBalances` admite paginación y devuelve un arreglo de cuentas de saldo en efectivo ordenadas por fecha de creación (las más recientes primero).

### Respuesta de ejemplo:

```json theme={null}
{
  "data": {
    "getWallet": {
      "bankCards": [BankCard],
      "bankAccounts": [BankAccount],
      "paypalAccounts": [Paypal],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": {
          "availableBalance": "50.00",
          "totalBalance": "50.00",
          "lifetimeBalance": "125.00"
        },
        "cashBalance": {
          "availableBalance": "100.00",
          "totalBalance": "100.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "500.00"
        },
        "giftCardCashBalance": {
          "availableBalance": "25.00",
          "totalBalance": "25.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "75.00"
        },
        "userCashBalances": [
          {
            "userCashBalanceId": "123e4567-e89b-12d3-a456-426614174000",
            "totalCashBalance": "100.00",
            "availableCashBalance": "100.00",
            "lifetimeCashBalance": "500.00",
            "nickname": "Primary Account",
            "status": "ACTIVE",
            "createdAt": "2024-01-15T10:30:00Z"
          },
          {
            "userCashBalanceId": "223e4567-e89b-12d3-a456-426614174001",
            "totalCashBalance": "25.00",
            "availableCashBalance": "25.00",
            "lifetimeCashBalance": "75.00",
            "nickname": "Savings",
            "status": "ACTIVE",
            "createdAt": "2024-02-20T14:15:00Z"
          }
        ]
      }
    }
  }
}
```

### Consulta con paginación:

Puedes paginar a través de las cuentas de saldo en efectivo usando el parámetro `paginate`:

```graphql theme={null}
query {
  getWallet {
    balances {
      userCashBalances(paginate: { limit: 10, offset: 0 }) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
      }
    }
  }
}
```

### Campos de UserCashBalance:

| Campo                  | Tipo                  | Descripción                                                         |
| ---------------------- | --------------------- | ------------------------------------------------------------------- |
| `userCashBalanceId`    | UUID                  | Identificador único de la cuenta de saldo en efectivo del usuario   |
| `totalCashBalance`     | String                | Saldo total en efectivo en la cuenta                                |
| `availableCashBalance` | String                | Saldo en efectivo disponible que se puede usar para transacciones   |
| `lifetimeCashBalance`  | String                | Total acumulado depositado en esta cuenta                           |
| `nickname`             | String                | Apodo personalizado para la cuenta de saldo (opcional)              |
| `status`               | UserCashBalanceStatus | Estado de la cuenta de saldo en efectivo (p. ej., ACTIVE, INACTIVE) |
| `createdAt`            | DateTime              | Fecha y hora en que se creó la cuenta                               |

<br />

<StickyContactSalesBanner />