Saltar al contenido principal
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, 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 se ve afectado por 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 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 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 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 se debe debitar con cashBalanceId. Los retiros requieren el alcance MAKE_WITHDRAWAL. Consulta Retirar fondos a una cuenta externa 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

Antes de mover fondos, usa Consultar saldo de la cuenta 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.