> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Números de Cuenta Virtual
> Asigna a cada cuenta de gasto un número de ruta y de cuenta reales para que remitentes externos puedan ingresar fondos vía RTP, FedNow, Wire o ACH.
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](/features/spend-accounts) 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
```mermaid theme={null}
flowchart LR
subgraph EXT["External Senders"]
E1[Employer payroll]
E2[User's outside bank]
E3[Customer or partner]
end
subgraph VANS["Virtual Account Numbers"]
V1["VAN — primary\nrouting + account"]
V2["VAN — secondary\nrouting + account"]
end
SA[("Spend Account\nUserCashBalance\nholds the balance")]
OUT["Gift cards · Virtual cards\nInternal transfers · Withdrawals"]
E1 -->|ACH credit| V1
E2 -->|RTP / FedNow| V1
E3 -->|Wire| V2
V1 --> SA
V2 --> SA
SA --> OUT
```
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](/features/withdraw-funds) o una [transferencia interna](/features/transfer-between-spend-accounts).
***
## 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.
```mermaid theme={null}
sequenceDiagram
participant S as External sender
participant B as Receiving bank
participant F as Fluz
participant SA as Spend account
S->>B: Push funds to VAN routing + account
B->>F: Credit received (RTP / FedNow / Wire / ACH)
F->>F: Match VAN to spend account
F->>SA: Post deposit (funding source: virtual account)
F-->>S: Funds available to spend
```
***
## 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`
```graphql theme={null}
query getSpendAccountVirtualAccountNumbers($userCashBalanceId: UUID!) {
getSpendAccountVirtualAccountNumbers(userCashBalanceId: $userCashBalanceId) {
virtualAccountNumberId
routingNumber
accountNumber
accountType
bankName
isPrimary
status
createdAt
}
}
```
```json Variables theme={null}
{
"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](/api-reference/types/spend-account-virtual-account-number) 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](/features/virtual-account-documents) 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](/features/virtual-account-documents) 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
La cuenta que realmente mantiene el saldo.
Instrucciones de pago, formularios de depósito y cartas de estado.
Ingresa fondos desde una cuenta bancaria o tarjeta vinculada.
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.