Saltar al contenido principal
Una cuenta de gasto es una cuenta de saldo en efectivo dentro de Fluz que un usuario utiliza para guardar, organizar y rastrear fondos. Cada cuenta tiene su propio apodo, por lo que un usuario puede separar los gastos por propósito — por ejemplo, “Viajes del equipo”, “Billetera de operaciones” o “Presupuesto de marketing” — y cada cuenta mantiene sus propios saldos en curso. Las cuentas de gasto son la billetera de la cual se nutre todo lo demás: contienen los fondos utilizados para comprar tarjetas de regalo, financiar transacciones con tarjetas virtuales y recibir depósitos y transferencias.
“Cuenta de gasto” y “cuenta de saldo en efectivo” son lo mismo.En la API, una cuenta de gasto está representada por el tipo UserCashBalance, y las operaciones se nombran ...UserCashBalance (p. ej., createUserCashBalance). En esta página usamos “cuenta de gasto” en todo momento.

Saldos

Cada cuenta de gasto registra tres saldos, todos devueltos como strings: Un usuario puede tener múltiples cuentas de gasto, y una se marca como la predeterminada (isDefault: true).

Qué puedes hacer


Ciclo de vida de la cuenta

Una cuenta de gasto pasa por un pequeño conjunto de estados (UserCashBalanceStatus): típicamente ACTIVE, y CLOSED una vez cerrada. Cerrar una cuenta es más que un cambio de estado. Cuando cierras una cuenta de gasto con un saldo disponible restante, ese saldo debe trasladarse a otra cuenta de gasto. Si alguna tarjeta virtual está financiada por la cuenta que se va a cerrar, debes reasignarla a una nueva fuente de fondos o bloquearla como parte de la misma solicitud.
Cerrar una cuenta requiere que resuelvas su saldo y sus tarjetas dependientes.Si la cuenta aún tiene un saldo disponible, proporciona transferUserCashBalanceId para moverlo. Si hay tarjetas virtuales vinculadas a la cuenta, proporciona newFundingSource para reasignarlas o lockAllVirtualCards para bloquearlas. Consulta Cerrar cuentas de gasto para la referencia completa de la entrada.

Cómo encajan las cuentas de gasto

Las cuentas de gasto están en el centro de la billetera de un usuario:

Requisitos

Listar cuentas de gasto requiere el alcance LIST_PAYMENT. Crear, editar y cerrar cuentas de gasto requiere el alcance MANAGE_PAYMENT. Asegúrate de que el token de acceso del usuario incluya el alcance correcto antes de llamar estas operaciones.
¿Quieres saber más? Habla con nuestros expertos para obtener más información o solicitar una demostración.