Skip to main content
Mueve dinero entre la billetera de Fluz de un usuario y sus cuentas externas: una cuenta bancaria, una tarjeta bancaria o una 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 fuera de 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, y para enviar fondos a una cuenta de Fluz diferente usa Transferencias de cuenta a cuenta.

​
Saldos de Fluz

Los depósitos y retiros interactúan con varios saldos distintos. Saber qué saldo afecta un movimiento es importante, porque no todos los saldos se pueden retirar.
El saldo de tarjetas de regalo es solo para gastar.Los fondos acreditados al saldo de tarjetas de regalo — ya sea depositando a GIFT_CARD_BALANCE o canjeando una Tarjeta de Regalo de Fluz — pueden usarse para compras pero no se pueden retirar a una cuenta externa.

​
Depósito de fondos

Usa la mutación depositCashBalance para ingresar 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 a un saldo en efectivo, puedes dirigirlo a una cuenta de gasto específica con userCashBalanceId. Los depósitos pueden liquidarse al instante o dentro de 2–5 días hábiles según la fuente de fondos. Requiere el alcance MAKE_DEPOSIT. Los depósitos financiados por una tarjeta de débito hacia CASH_BALANCE pueden procesarse como transacciones de financiación de cuenta (AFT), que tienen su propia tarifa. Fluz aplica esto automáticamente cuando está disponible, así que lee depositFee de la respuesta en lugar de calcularla — ver Depositar fondos desde cuentas externas. Consulta Depositar fondos desde cuentas externas 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 balance de tarjetas de regalo 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: Al retirar desde un saldo en efectivo, especifica de qué cuenta de gasto debitar con cashBalanceId. Los retiros requieren el alcance MAKE_WITHDRAWAL. Las tarifas se deducen del retiro, por lo que el destino recibe menos que amount. Cotiza primero la tarifa exacta, el monto neto y el tiempo de liquidación con getWithdrawFeeEstimate. Consulta Retirar fondos a cuenta externa para la referencia completa de entrada, manejo de errores y comportamiento multi-usuario.

​
Idempotencia

Depósito, canje y retiro deben incluir un idempotencyKey único generado por el cliente. Si la misma clave se envía 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

Antes de mover fondos, usa Verificar saldo de cuenta o getWallet para confirmar que el usuario tiene saldo disponible suficiente y para obtener los IDs de las fuentes de fondos relevantes.
¿Quieres saber más? Habla con nuestros expertos para obtener más información o solicitar una demostración.