Verification of Payee (VoP)

Visualizza come Markdown

Informazioni relative al pacchetto API

Payments | Money Transfers (v4.1) di Banca Sella

Il seguente articolo contiene informazioni su come integrare le API relative al servizio Verification of Payee (VoP) all'interno del pacchetto Money Transfer.

Si ricorda che la decisione di applicare o meno la Verification of Payee nei propri flussi API deve essere comunicata espressamente alla propria Filiale/Ufficio Commerciale Sella, che fornirà la documentazione appropriata per tracciare correttamente la volontà del Cliente di utilizzare questo strumento di controllo.

Introduzione

La Verification of Payee (VoP) consente di verificare la corrispondenza tra l'IBAN e il nome del beneficiario (o altri identificativi come Partita IVA / Codice LEI nel caso di trasferimenti tra aziende) indicati dall'ordinante di un bonifico prima di autorizzare l'invio dei fondi al destinatario.

Il servizio è attivo sia per i bonifici istantanei sia per i bonifici ordinari tra banche dell'area europea (con sede in uno Stato membro dell'UE la cui valuta è l'euro).

Come funziona

1. Creazione del pagamento: quando un cliente inizializza un pagamento, inserisce il nome del beneficiario (o altri identificativi come Partita IVA o Codice LEI) insieme all'identificativo del conto di pagamento (IBAN).
2. Verifica del beneficiario: prima di autorizzare l'operazione, viene inviata una richiesta VoP alla banca del beneficiario per verificare se l'IBAN e il nome del beneficiario (o altri identificativi come Partita IVA o Codice LEI) corrispondono.
3. Risultati della verifica del beneficiario: il servizio restituisce uno dei seguenti possibili risultati:
   • MATCH: il nome del beneficiario (o altri identificativi come Partita IVA o Codice LEI) corrisponde all'intestatario del conto di accredito.
   • CLOSE MATCH: il nome fornito è simile ma non identico al nome dell'intestatario del conto.
   • NO MATCH: quanto indicato dall'ordinante non corrisponde all'intestatario del conto di accredito.
   • NOT APPLICABLE: non è stato possibile procedere con la verifica.
4. Esecuzione dell'ordine di pagamento: in caso di esito MATCH, CLOSE MATCH e NOT APPLICABLE, l'ordine di pagamento viene eseguito senza richiedere un'ulteriore autorizzazione al cliente. In caso di NO MATCH, invece, l'ordine non viene eseguito a meno che il cliente non esprima una volontà differente.

Per maggiori informazioni sullo schema VoP nell'area SEPA, è possibile consultare il sito EPC (European Payments Council).

Variazioni sui flussi di integrazione API

Questo paragrafo descrive le alternative disponibili per i clienti.

CASO 1: Richiedere l'esecuzione della Verification of Payee (VoP)

Per ottenere un maggiore controllo e una maggiore sicurezza nell'esecuzione dei bonifici dal sistema di trasferimento, si raccomanda di eseguire la verifica VoP valorizzando il seguente header:

• X-VoP-Force-Verification: se impostato su true, l'header indica di eseguire la verifica VoP per la relativa chiamata. Se non specificato, il valore predefinito dell'header è false (ovvero non viene eseguita alcuna Verification of Payee).

In questo scenario, l'API POST Create Money Transfer restituisce un errore 400 - Bad Request se il risultato della Verification of Payee è NO MATCH e l'ordine di pagamento non viene eseguito.

Lo schema seguente mostra un caso d'uso dell'header X-VoP-Force-Verification.

Se, durante la richiesta di esecuzione di un bonifico, viene restituito un errore 400 Bad Request, è comunque possibile forzarne l'esecuzione tramite una richiesta all'API POST Create Money Transfer, utilizzando lo stesso request body e impostando il seguente header:

• X-VoP-Id: contiene l'ID presente nel risultato vopResponse della chiamata precedente. Se non specificato, il valore predefinito dell'header è null.

Il sistema verifica la corrispondenza dei dati forniti in precedenza con la nuova richiesta e, in caso di corrispondenza, il bonifico viene eseguito.

Lo schema seguente mostra l'interazione nel caso di utilizzo dell'header X-VoP-Id.

CASO 2: Non eseguire la Verification of Payee (VoP)

Il cliente può richiedere che la verifica VoP non venga eseguita durante l'esecuzione di bonifici tramite API (Money Transfer).

Per chi ha implementato le API Fabrick prima del 9 ottobre 2025, non saranno necessari adeguamenti tecnologici per escludere l'applicazione della VoP; sarà tuttavia necessario contattare il proprio referente commerciale per comunicare chiaramente la propria decisione in merito all'utilizzo della verifica VoP.

Ambienti di integrazione

Il servizio VoP sarà presto disponibile nei seguenti ambienti a supporto del ciclo di sviluppo:

Ambiente	Scopo	Base URL
Sandbox	Sviluppo e test	https://sandbox.fabrick.com
Production	Operazioni live	https://api.fabrick.com