La Verification of Payee (VoP) verifica che il nome su un pagamento corrisponda all'intestatario del conto dietro l'IBAN prima che il denaro si muova. Con il Regolamento UE sui pagamenti istantanei è obbligatoria per i bonifici in euro, ma l'integrazione in sé non deve essere complessa. Con RoxPay si riduce a pochi passi.
1. Ottieni le credenziali sandbox
Inizia richiedendo le chiavi API sandbox. La sandbox riproduce il comportamento di produzione con dati di test, così puoi costruire e verificare il flusso senza toccare conti reali o clienti veri.
2. Chiama l'endpoint di verifica
Invia il nome del beneficiario e l'IBAN a un unico endpoint. RoxPay instrada il controllo allo schema e alla banca corretti, normalizza la risposta e restituisce un esito chiaro — non gestisci tu le singole connessioni bancarie.
Un endpoint, copertura completa
Invece di integrare separatamente ogni banca o schema, chiami un solo endpoint RoxPay e ottieni risultati normalizzati sui conti raggiungibili in SEPA.
3. Gestisci i quattro esiti
- Match: nome e intestatario coincidono — lascia procedere il pagamento.
- Quasi-match: corrispondenza parziale (es. abbreviazione) — mostra il nome suggerito e fai confermare il pagatore.
- Nessun match: i nomi differiscono — avvisa il pagatore prima di continuare.
- Verifica non possibile: la banca non ha risposto — spiega e lascia decidere il pagatore.
4. Progetta l'esperienza del pagatore
La chiamata tecnica è solo metà del lavoro. Mappa ogni esito in una UI chiara e non allarmante così i pagatori capiscono cosa fare. Un quasi-match dovrebbe suggerire il nome verificato; un nessun match dovrebbe avvisare senza bloccare del tutto i pagamenti legittimi.
5. Vai live
Una volta che il flusso gestisce ogni esito e hai eseguito test di carico contro picchi realistici, sostituisci le chiavi sandbox con quelle di produzione. Il monitoraggio e il logging di RoxPay ti aiutano a osservare l'integrazione nei giorni dopo il go-live.