Descripción general

Una cuenta de saldo en efectivo del usuario es una cuenta de gasto que permite a los usuarios administrar y rastrear sus fondos disponibles dentro de la plataforma Fluz. Cada cuenta de saldo en efectivo se identifica por un apodo único y mantiene saldos separados para depósitos totales, disponibles y de por vida. Los usuarios pueden crear múltiples cuentas de saldo en efectivo (por ejemplo, “Viajes del equipo”, “Billetera de operaciones”, “Presupuesto de marketing”) para organizar sus gastos según diferentes propósitos. Las cuentas de saldo en efectivo son necesarias para realizar depósitos, comprar tarjetas de regalo y financiar transacciones con tarjeta virtual en la plataforma Fluz.

Crear cuenta de saldo en efectivo del usuario

Solicitud de ejemplo

Puedes crear una nueva cuenta de saldo en efectivo del usuario con la mutación createUserCashBalance. Esta mutación te permite configurar una nueva cuenta de gasto con un apodo personalizado para ayudar a organizar tus fondos. La consulta toma un objeto de entrada CreateUserCashBalanceInput.

{
  "query": "mutation createUserCashBalance($input: CreateUserCashBalanceInput!) { createUserCashBalance(input: $input) { userCashBalanceId totalCashBalance availableCashBalance lifetimeCashBalance nickname status createdAt }}",
  "variables": {
    "input": {
      "nickname": "Team Travel"
    }
  }
}

Esta mutación requiere el tipo de entrada CreateUserCashBalanceInput. Cualquier campo marcado con un signo de exclamación (!) en el esquema es obligatorio y debe incluirse en la solicitud.

Nombre del campo	Tipo	Descripción
nickname	String!	Un nombre personalizado para la cuenta de saldo en efectivo. Esto ayuda a identificar el propósito de la cuenta.

CreateUserCashBalanceInput

{
  "nickname": "Team Travel"
}

Respuesta de ejemplo

La respuesta de la mutación createUserCashBalance incluirá los detalles de la cuenta de saldo en efectivo recién creada, incluido su identificador único e información inicial de saldo.

{
  "data": {
    "createUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "Team Travel",
      "status": "ACTIVE",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  }
}

Campos de la respuesta

Nombre del campo	Tipo	Descripción
userCashBalanceId	UUID!	Identificador único de la cuenta de saldo en efectivo
totalCashBalance	String!	Saldo total en efectivo en la cuenta (inicia en 0)
availableCashBalance	String!	Saldo en efectivo disponible para uso inmediato (inicia en 0)
lifetimeCashBalance	String!	Total acumulado de todos los fondos depositados alguna vez (inicia en 0)
nickname	String	El nombre personalizado asignado a la cuenta
status	UserCashBalanceStatus!	Estado actual de la cuenta (ACTIVE, CLOSED o SUSPENDED)
createdAt	DateTime!	Marca de tiempo cuando se creó la cuenta

❗️ Se requiere autorización Esta mutación requiere el alcance MANAGE_PAYMENT. Asegúrate de que tu token de acceso tenga otorgado este alcance antes de intentar crear una cuenta de saldo en efectivo.

Funciones

Crear cuentas de gasto

Descripción general

Crear cuenta de saldo en efectivo del usuario

Solicitud de ejemplo

CreateUserCashBalanceInput

Respuesta de ejemplo

Campos de la respuesta

​Descripción general

​Crear cuenta de saldo en efectivo del usuario

​Solicitud de ejemplo

​CreateUserCashBalanceInput

​Respuesta de ejemplo

​Campos de la respuesta

Descripción general

Crear cuenta de saldo en efectivo del usuario

Solicitud de ejemplo

CreateUserCashBalanceInput

Respuesta de ejemplo

Campos de la respuesta