L'API Verification of Payee
Una chiamata REST in tempo reale per confermare il nome del beneficiario rispetto a un IBAN — esito, BIC della banca rispondente e tempo di elaborazione nella risposta. Basata sulla piattaforma RoxPay e sullo schema SEPA VoP.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
Verifica del beneficiario in un'unica richiesta
L'API Verification of Payee espone lo schema SEPA VoP come un endpoint REST pulito: invii un nome e un IBAN e ricevi un esito standardizzato in tempo reale — senza dover costruire l'infrastruttura dello schema.
È la stessa verifica che RoxPay esegue all'interno della sua piattaforma bancaria SwiftLine / RoxBusiness, disponibile per banche, PSP e aziende tramite un'API autenticata e una dashboard. Ogni risposta include il tipo di corrispondenza, il BIC dell'istituto rispondente e il tempo di elaborazione del PSP.
Poiché è erogata sull'infrastruttura europea di open banking di RoxPay, ti colleghi una volta e raggiungi la verifica del beneficiario su tutta la SEPA — invece di integrarti con ogni banca rispondente.
Da zero a verificato in quattro passaggi
Un'integrazione REST standard che si inserisce nel tuo flusso di pagamento esistente.
Ottieni le credenziali
Attiva il servizio e autenticati con un bearer token — nessun onboarding banca per banca da gestire.
Invia nome + IBAN
Invia in POST nome e IBAN del beneficiario all'endpoint di verifica, con un tuo id di riferimento opzionale per la riconciliazione.
Leggi l'esito
Ricevi l'esito (corrispondenza / parziale / nessuna / non applicabile), il BIC rispondente e il tempo di elaborazione.
Agisci nella tua UI
Mostra un segnale chiaro a chi paga, oppure subordina all'esito una distinta, un mandato o un passo di onboarding.
Cosa restituisce l'API
Ogni risposta corrisponde a un codice dello schema SEPA VoP, così la tua logica resta semplice.
MATCH · MTCH
Il nome corrisponde al titolare del conto. La risposta riporta anche il BIC della banca rispondente.
CLOSE_MATCH · CMTC
Corrispondenza parziale — gestiscila come avviso e suggerisci il nome verificato.
NO_MATCH · NMTC
Il nome non corrisponde. Mostra un avviso chiaro prima della conferma del pagamento.
NOT_APPLICABLE · NOAP
Verifica non disponibile ora per questo IBAN. Lascia decidere l'utente.
Costruire la VoP da soli vs. l'API
Cosa eviti chiamando un endpoint invece di aderire allo schema da solo.
Sviluppo interno
- Connettività allo schema Integrazione per ogni PSP rispondente
- Tempo di attivazione Mesi
- Dettaglio della risposta Lo normalizzi tu
- Riuso tra prodotti Da ricablare per ogni flusso
- Manutenzione A tuo carico
API Verification of Payee
- Connettività allo schema Una connessione, copertura SEPA
- Tempo di attivazione Settimane
- Dettaglio della risposta Esito standardizzato + BIC + tempi
- Riuso tra prodotti Un'API per UI, massivo e mandati
- Manutenzione Gestita dalla piattaforma
Un'API, tre destinatari
Lo stesso endpoint risolve esigenze molto diverse.
Banche e PSP
Offri la Verification of Payee ai correntisti e rispetta il Regolamento sui Pagamenti Istantanei senza costruire la connettività allo schema.
Sviluppatori
Un contratto REST prevedibile, risposte in tempo reale, i tuoi id di riferimento e codici di schema chiari su cui ramificare.
Aziende ed ERP
Verifica in blocco gli IBAN di fornitori e stipendi prima di una distinta, riducendo il rischio di dirottamento fatture.
L'API, spiegata
Le prime domande di sviluppatori e team di prodotto.
Sì. Una chiamata di verifica risponde in modo sincrono, di norma in molto meno di un secondo, e include il BIC della banca rispondente e il tempo di elaborazione del PSP per monitorare le prestazioni.
Le chiamate sono autenticate con un bearer token su HTTPS. Puoi anche usare la dashboard RoxBusiness per verifiche estemporanee senza scrivere codice.
Un esito normalizzato (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), il codice di corrispondenza dello schema SEPA, un id di verifica, il BIC rispondente, il tempo di elaborazione e il tuo id esterno opzionale.
Sì — chiama l'endpoint per ogni record per verificare un intero file di fornitori o beneficiari prima di una distinta. È pensata per alti volumi.
Sì. La verifica confronta il nome inviato con il titolare del conto registrato, sia esso una persona fisica o un'azienda, ed è usata nel flusso dei mandati SEPA Direct Debit di RoxPay come pre-controllo.
NO_MATCH non è un errore di trasporto: è una risposta 200 valida che indica che il nome non appartiene all'IBAN. Trattala come uno stop deciso nella tua UI o nella distinta: mostra un avviso chiaro, blocca l'approvazione automatica e fai ricontrollare il beneficiario prima dell'invio.
CLOSE_MATCH (codice di schema CMTC) significa che il nome è quasi esatto — manca un secondo nome, c'è una ragione sociale diversa dal nome commerciale. La risposta riporta il nome verificato del titolare, così puoi mostrarlo come suggerimento e chiedere conferma a chi paga invece di rifiutare il pagamento.
Per le persone giuridiche lo schema consente la verifica sull'identificativo dell'organizzazione (es. Partita IVA / Codice Fiscale) oltre che sul nome. Invii l'identificativo nella richiesta e l'API restituisce l'esito standard — utile quando ragione sociale e nome commerciale non coincidono.
Sì. Per una distinta, scorri il file di fornitori o stipendi e chiama l'endpoint di verifica per ogni record prima di rilasciare il lotto. È pensata per alti volumi, così la tesoreria può validare in blocco gli IBAN delle fatture fornitori prima di ogni bonifico.
Integra la Verification of Payee
Ottieni le credenziali e vai live sullo schema SEPA VoP con un'unica integrazione REST.