Costruire la Verification of Payee da zero significa integrarsi con ogni PSP rispondente e normalizzare ogni risposta. Un'API VoP elimina quel lavoro: ti colleghi una volta e il fornitore gestisce la connettività allo schema su tutta la SEPA. Il tuo compito diventa una pulita integrazione richiesta/risposta.
1. Autenticati
Le chiamate avvengono su HTTPS e sono autenticate con un bearer token. Conserva la credenziale come segreto, mai nel client. Per verifiche manuali o a basso volume è disponibile una dashboard, così chi non programma può verificare senza scrivere codice.
2. Invia la richiesta
Invia in POST nome e IBAN del beneficiario all'endpoint di verifica. Includi un tuo id di riferimento per riconciliare l'esito con il pagamento o il record di onboarding a cui appartiene.
Mantienila idempotente
Passa un id esterno stabile a ogni richiesta così i retry non creano verifiche duplicate e puoi ricondurre una voce di log all'azione originaria.
3. Gestisci i quattro esiti
Ogni risposta corrisponde a un codice dello schema SEPA, così la ramificazione resta semplice:
- MATCH (MTCH) — il nome corrisponde al titolare; procedi con sicurezza.
- CLOSE_MATCH (CMTC) — quasi esatto; mostra il nome verificato suggerito e chiedi conferma all'utente.
- NO_MATCH (NMTC) — mostra un avviso chiaro prima della conferma del pagamento.
- NOT_APPLICABLE (NOAP) — verifica non disponibile ora; lascia decidere l'utente.
La risposta riporta anche il BIC della banca rispondente e il tempo di elaborazione, utili per monitoraggio e log di audit.
4. Riutilizzala ovunque
Poiché il contratto è lo stesso, l'unico endpoint serve a più scopi: una verifica in linea mentre chi paga rivede un nuovo beneficiario, la verifica massiva di un file fornitori e un pre-controllo dentro un flusso di mandato SEPA Direct Debit. RoxPay usa la VoP esattamente così — anche come pre-controllo obbligatorio prima di emettere il link di firma di un mandato SDD.