Números de Cuenta Virtual

Un número de cuenta virtual (VAN) es un número de ruta y de cuenta reales, emitidos por un banco, que apuntan a una de las cuentas de gasto de un usuario. Cualquier persona fuera de Fluz —un empleador, un banco, un cliente, un marketplace— puede enviar dinero a ese par de número de ruta y cuenta, y los fondos llegan a la cuenta de gasto como un depósito. El VAN no guarda dinero. La cuenta de gasto mantiene el saldo. Un VAN es simplemente otra dirección que enruta hacia ella.

Un saldo, muchas direcciones.Una cuenta de gasto puede tener más de un número de cuenta virtual activo, y exactamente uno de ellos está marcado como principal. Cada VAN de la cuenta abona el mismo saldo: existen para que puedas separar remitentes, como nómina versus un cliente específico, sin dividir los fondos.

Cómo encaja todo

El dinero entra a través de un VAN. El dinero que sale igualmente deja la cuenta de gasto de la misma forma de siempre: financiación de tarjetas de regalo y tarjetas virtuales, transferencias internas y retiros a una cuenta externa vinculada.

Rieles compatibles

Los créditos enviados a un número de cuenta virtual se aceptan a través de cuatro rieles:

Riel	Dirección	Disponibilidad típica	Notas
RTP	Crédito (entrada)	Casi instantáneo, 24/7	El banco del remitente debe participar en The Clearing House RTP.
FedNow	Crédito (entrada)	Casi instantáneo, 24/7	El banco del remitente debe ser participante de FedNow.
Wire	Crédito (entrada)	Mismo día hábil	Wires domésticos. Las comisiones del banco emisor las fija el remitente.
ACH	Crédito (entrada)	1–2 días hábiles	ACH crédito estándar, incluyendo depósito directo de nómina.

ACH débito (pull) aún no es compatible.Un número de cuenta virtual actualmente solo puede recibir fondos. No puedes usar el número de ruta y de cuenta del VAN para originar un ACH débito: un tercero no puede extraer dinero de una cuenta de gasto usando estas credenciales. La compatibilidad con ACH débito llegará pronto.Para mover dinero hacia afuera hoy, usa Retirar fondos a una cuenta externa o una transferencia interna.

Cómo se ve un crédito

Cuando llegan fondos a un número de cuenta virtual, Fluz registra un depósito estándar en la cuenta de gasto de destino. La fuente de fondos del depósito es la cuenta virtual —no una tarjeta bancaria, cuenta bancaria o PayPal— porque el dinero se originó fuera de Fluz y fue empujado hacia adentro en lugar de extraído desde un método de pago vinculado. Esto significa:

El crédito aparece en el mismo historial de transacciones y depósitos que cualquier otro depósito.
No hay un objeto de fuente de fondos vinculado para conciliar, ni una retención en tarjeta de respaldo, porque no se debitó nada del usuario.
El depósito es atribuible al VAN específico que lo recibió, para que puedas distinguir un crédito de nómina de un pago de cliente cuando una cuenta de gasto tiene múltiples VAN.

Recuperar los números de cuenta virtual de un usuario

Usa getSpendAccountVirtualAccountNumbers para listar los VAN activos en una cuenta de gasto. Devuelve cada VAN activo, y uno de ellos está marcado como principal. Alcance requerido: LIST_PAYMENT

query getSpendAccountVirtualAccountNumbers($userCashBalanceId: UUID!) {
  getSpendAccountVirtualAccountNumbers(userCashBalanceId: $userCashBalanceId) {
    virtualAccountNumberId
    routingNumber
    accountNumber
    accountType
    bankName
    isPrimary
    status
    createdAt
  }
}

Variables

{
  "userCashBalanceId": "9c1f6b2e-4d7a-4c3b-9f11-2a5e8b0d6c74"
}

Argumento	Tipo	Requerido	Descripción
`userCashBalanceId`	`UUID!`	Sí	La cuenta de gasto cuyos números de cuenta virtual deseas.

Devuelve [SpendAccountVirtualAccountNumber!]!. Consulta la referencia de tipo para la lista completa de campos.

Visualización de números de cuenta.El número de cuenta completo de un VAN es sensible. Enmascararlo en vistas de lista y revelar el valor completo solo ante una acción explícita del usuario, de la misma forma que tratarías un PAN de tarjeta. Cuando un usuario necesite entregar los datos a un tercero, prefiere los artefactos PDF generados descritos en Documentos de Cuenta Virtual sobre copias de texto libre.

Entregar los detalles a un tercero

En lugar de pedir a un usuario que transcriba un número de ruta y de cuenta en un portal de nómina o que lo envíe por correo electrónico a una contraparte, Fluz genera artefactos PDF bajo demanda:

Documento	Consulta	Caso de uso
Instrucciones de pago	`getSpendAccountPaymentInstructions`	Entregar a un cliente o socio los datos necesarios para enviar un wire o un crédito ACH.
Formulario de depósito de nómina	`getSpendAccountPaycheckDepositForm`	Formulario de depósito directo prellenado para el departamento de nómina de un empleador.
Carta de estado de cuenta	`getSpendAccountStatusLetter`	Constancia de cuenta, opcionalmente mostrando el saldo actual.

Los tres usan por defecto el VAN principal de la cuenta de gasto cuando se omite virtualAccountNumberId, y los tres requieren el alcance LIST_PAYMENT. Consulta Documentos de Cuenta Virtual para la referencia completa.

Requisitos

El usuario debe tener al menos una cuenta de gasto activa.
Leer números de cuenta virtual y generar documentos requiere el alcance LIST_PAYMENT en el token de acceso del usuario.
Los números de cuenta virtual son aprovisionados por Fluz. No se crean a través del API.

Relacionado

Cuentas de Gasto

La cuenta que realmente mantiene el saldo.

Documentos de Cuenta Virtual

Instrucciones de pago, formularios de depósito y cartas de estado.

Depositar Fondos

Ingresa fondos desde una cuenta bancaria o tarjeta vinculada.

Fuentes de Fondos

Cómo Fluz clasifica el dinero que entra.

¿Quieres saber más? Habla con nuestros expertos para más información o para solicitar una demo.

​Cómo encaja todo

​Rieles compatibles

​Cómo se ve un crédito

​Recuperar los números de cuenta virtual de un usuario

​Entregar los detalles a un tercero

​Requisitos

​Relacionado

Cuentas de Gasto

Documentos de Cuenta Virtual

Depositar Fondos

Fuentes de Fondos

Cómo encaja todo

Rieles compatibles

Cómo se ve un crédito

Recuperar los números de cuenta virtual de un usuario

Entregar los detalles a un tercero

Requisitos

Relacionado