Un esempio di Verification of Payee
Come appare davvero un controllo VoP? Ecco un esempio concreto: la richiesta che invii, la risposta JSON che ricevi e come si presenta ciascuno dei quattro esiti.
Come appare un controllo VoP nella pratica
Un controllo Verification of Payee è un'unica domanda in tempo reale: questo nome appartiene a questo IBAN? Invii il nome del beneficiario e l'IBAN e la banca risponditrice restituisce un esito standardizzato prima che il pagamento sia autorizzato.
Di seguito un esempio semplificato di richiesta e risposta. I nomi esatti dei campi dipendono dal fornitore, ma ogni risposta VoP corrisponde agli stessi quattro esiti dello schema.
Esempio di richiesta
POST /v1/verification-of-payee
Authorization: Bearer <token>
{
"payee": {
"name": "Maria Rossi",
"iban": "DE89370400440532013000"
}
}{
"outcome": "match",
"matchedName": "Maria Rossi",
"respondingBic": "COBADEFFXXX",
"requestId": "vop_8f3a2c91",
"processedAt": "2026-06-24T10:00:00Z"
}I quattro esiti, con esempi
Ogni risposta VoP si riconduce a uno di questi quattro risultati.
match
Il nome corrisponde pienamente al titolare — es. hai inviato 'Maria Rossi' e il conto è 'Maria Rossi'.
close match
Quasi corretto — es. hai inviato 'M. Rossi' e il titolare è 'Maria Rossi'. Il nome verificato viene restituito come suggerimento.
no match
Il nome non corrisponde all'IBAN — es. 'Acme Srl' su un conto di 'Maria Rossi'. Un forte segnale di frode.
not possible
Il controllo non è stato completato — es. la banca del beneficiario è irraggiungibile o l'IBAN non è ancora coperto.
Provalo con i tuoi dati
La sandbox di RoxPay ti permette di inviare nomi e IBAN reali e vedere esattamente quale esito torna — il modo più rapido per capire il comportamento della VoP prima di integrarla.
FAQ
È una piccola risposta strutturata che contiene l'esito (corrispondenza, parziale, nessuna o non possibile) e, per una corrispondenza parziale, il nome verificato come suggerimento, oltre al BIC della banca risponditrice e un riferimento della richiesta.
Inviare 'M. Rossi' quando il titolare è 'Maria Rossi' restituisce in genere una corrispondenza parziale, con 'Maria Rossi' suggerito così chi paga può confermare o correggere il nome.
Come minimo il nome del beneficiario e l'IBAN. Per le persone giuridiche si può includere anche un identificativo dell'organizzazione (come partita IVA o numero di registrazione) per migliorare l'accuratezza.
Sì. RoxPay fornisce una sandbox e la documentazione API per inviare richieste di esempio e ispezionare la risposta per ogni esito prima di andare in produzione.
Vedi l'API VoP in azione
Ottieni l'accesso alla sandbox e testa richieste reali su tutti e quattro gli esiti.