> ## 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 Mueve dinero entre la **billetera de Fluz** de un usuario y sus **cuentas externas**: una cuenta bancaria, tarjeta bancaria o billetera digital (PayPal, Venmo). Los depósitos traen dinero a la billetera de Fluz desde una fuente externa para financiar compras; los retiros envían dinero desde la billetera de Fluz hacia un destino externo vinculado. Esto difiere de mover dinero dentro de Fluz: para trasladar fondos entre las propias cuentas de gasto de un usuario usa [Transferir fondos entre cuentas de gasto](/features/transfer-between-spend-accounts), y para enviar fondos a una cuenta de Fluz diferente usa [Transferencias de cuenta a cuenta](/features/account-to-account-transfers). | Dirección | Página | Qué hace | | ----------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | **Entrada** | [Depositar fondos desde cuentas externas](/features/deposit-from-external-accounts) | Agrega dinero a un saldo de Fluz desde una fuente de fondos vinculada. | | **Entrada** | [Canjear tarjeta de regalo de Fluz al saldo de tarjetas de regalo](/features/redeem-fluz-gift-card) | Acredita un código de tarjeta de regalo de Fluz al saldo de tarjetas de regalo. | | **Salida** | [Retirar fondos a una cuenta externa](/features/withdraw-to-external-account) | Envía dinero desde un saldo de Fluz a una cuenta externa vinculada. | *** ## Saldos de Fluz Los depósitos y retiros interactúan con varios saldos distintos. Saber qué saldo se ve afectado por un movimiento es importante, porque no todos los saldos se pueden retirar. | Saldo | Financiado por | Retirable | | ------------------------------- | ---------------------------------------------------------------------- | ------------------------ | | **Saldo en efectivo** | Depósitos desde una fuente de fondos | ✓ | | **Saldo de recompensas** | Cashback ganado en compras | ✓ | | **Saldo de tarjetas de regalo** | Depósitos a `GIFT_CARD_BALANCE` y tarjetas de regalo de Fluz canjeadas | ✗ (solo para gastar) | | **Saldo de reserva** | Depósitos a `RESERVE_BALANCE` | ✗ (mantenido en reserva) | **El saldo de tarjetas de regalo es solo para gastar.** Los fondos acreditados al saldo de tarjetas de regalo —ya sea depositando en `GIFT_CARD_BALANCE` o canjeando una tarjeta de regalo de Fluz— se pueden usar para compras pero no se pueden retirar a una cuenta externa. *** ## Depósito de fondos Usa la mutación `depositCashBalance` para mover dinero a Fluz desde una fuente de fondos vinculada. Tú eliges el **saldo de destino** (`CASH_BALANCE`, `GIFT_CARD_BALANCE` o `RESERVE_BALANCE`) y la **fuente de fondos** — un `bankAccountId`, `bankCardId` o `paypalVaultId` obtenido de `getWallet`. Al depositar en un saldo en efectivo, puedes dirigirlo a una cuenta de gasto específica con `userCashBalanceId`. Los depósitos pueden liquidarse de forma instantánea o dentro de 2–5 días hábiles según la fuente de fondos. Requiere el alcance `MAKE_DEPOSIT`. Consulta [Depositar fondos desde cuentas externas](/features/deposit-from-external-accounts) para la referencia completa de entrada y respuesta. *** ## Canjear una tarjeta de regalo de Fluz La tarjeta de regalo de Fluz es un tipo especial de depósito. La mutación `redeemFluzGiftCard` acredita un **código** de tarjeta de regalo directamente al saldo de tarjetas de regalo del usuario (`giftCardCashBalance`). Los canjes son instantáneos y cualquier tarifa de activación se refleja en `depositFee`. Requiere el alcance `MAKE_DEPOSIT`. Consulta [Canjear tarjeta de regalo de Fluz al saldo de tarjetas de regalo](/features/redeem-fluz-gift-card) para más detalles. *** ## Retiro de fondos Usa la mutación `withdrawCashBalance` para enviar dinero fuera de Fluz a una cuenta externa vinculada. Eliges el **saldo de origen** (`CASH_BALANCE` o `REWARDS_BALANCE`) y un **método de retiro**, proporcionando el ID de destino correspondiente: | Método | Campo requerido | Notas | | ----------- | ---------------- | -------------------------------------------------------------------------------------------------------------- | | `BANK_ACH` | `bankAccountId` | Transferencia ACH a una cuenta bancaria vinculada. Normalmente se liquida en 1–3 días hábiles. Sin comisiones. | | `BANK_CARD` | `bankCardId` | Transferencia push-to-card a una tarjeta de débito vinculada elegible. Puede tener comisiones. | | `PAYPAL` | `paypalVaultId` | Transferencia a una cuenta de PayPal vinculada. Puede tener comisiones. | | `VENMO` | `venmoAccountId` | Transferencia a una cuenta de Venmo vinculada. Puede tener comisiones. | Al retirar desde un saldo en efectivo, especifica de qué cuenta de gasto se debe debitar con `cashBalanceId`. Los retiros requieren el alcance `MAKE_WITHDRAWAL`. Consulta [Retirar fondos a una cuenta externa](/features/withdraw-to-external-account) para la referencia completa de entrada, manejo de errores y comportamiento multi-asiento. *** ## Idempotencia Los depósitos, canjes y retiros deben incluir un `idempotencyKey` único generado por el cliente. Si se envía la misma clave más de una vez, la API devuelve el resultado de la solicitud original en lugar de procesarla de nuevo, evitando movimientos de dinero duplicados. Genera siempre un UUID nuevo por solicitud. *** ## Requisitos de un vistazo | Acción | Mutación | Alcance | | ------------------------------------- | --------------------- | ----------------- | | Depositar fondos | `depositCashBalance` | `MAKE_DEPOSIT` | | Canjear una tarjeta de regalo de Fluz | `redeemFluzGiftCard` | `MAKE_DEPOSIT` | | Retirar fondos | `withdrawCashBalance` | `MAKE_WITHDRAWAL` | Antes de mover fondos, usa [Consultar saldo de la cuenta](/check-account-balance) o `getWallet` para confirmar que el usuario tiene saldo disponible suficiente y para obtener los IDs relevantes de fuentes de fondos. *** ¿Quieres saber más? Habla con nuestros expertos para obtener más información o solicitar una demostración.