---
title: "Introduzione"
description: "Il package Virtual IBANs v4.0 mette a disposizione un insieme di API progettate per la gestione avanzata dei Virtual IBAN all’interno dei conti correnti aziendali."
url: "https://docs.fabrick.com/payment-institution/banking-as-a-service/virtual-iban/"
language: "it"
---

>

# Introduzione

Il package **Virtual IBANs v4.0** mette a disposizione un insieme di API progettate per la gestione avanzata dei Virtual IBAN all’interno dei conti correnti aziendali.

La soluzione è pensata per supportare in modo scalabile le esigenze di aziende, piattaforme fintech, marketplace e istituzioni che necessitano di:

- gestire molteplici Virtual IBAN collegati a un conto principale (parent account),
- semplificare il processo di riconciliazione degli incassi,
- automatizzare flussi di pagamento in entrata e in uscita,
- mantenere un tracciamento chiaro e strutturato delle operazioni.

## Obiettivi del package

Il package mira a:

- **Migliorare la riconciliazione automatica** dei pagamenti in ingresso tramite Virtual IBAN univoci per cliente, transazione, contratto o progetto.
- **Semplificare la contabilità aziendale**, eliminando la necessità di analisi manuali o matching complessi.
- **Consentire la gestione programmatica** dell’intero ciclo di vita di un Virtual IBAN.
- **Garantire visibilità completa** sulle operazioni legate al conto principale e ai suoi Virtual IBAN correlati.

## Funzionalità principali

Il package offre endpoint per:

### 1. Creazione di Virtual IBAN

Permette di generare nuovi Virtual IBAN collegati a un conto esistente, includendo descrizioni opzionali utili per identificazioni logiche o amministrative.

### 2. Consultazione dei Virtual IBAN

Include funzionalità per:

- ottenere la lista di tutti i Virtual IBAN associati a un conto,
- recuperare i dettagli di un singolo Virtual IBAN,
- verificarne lo stato (attivo/inattivo),
- accedere alle informazioni di attivazione e disattivazione.

### 3. Gestione dello stato

È possibile modificare lo stato di un Virtual IBAN, ad esempio mettendolo **inattivo** quando non serve più.

### 4. Movimentazione

Il package consente di:

- recuperare le informazioni sul **conto principale** associato,
- consultare i **movimenti** relativi al conto principale in relazione ai Virtual IBAN collegati.

### 5. Integrazione con le operazioni di pagamento

Supporta anche l’avvio di **money transfer** sfruttando Virtual IBAN, facilitando flussi di pagamento integrati.