Building Verification of Payee from scratch means integrating with each responding PSP and normalising every response. A VoP API removes that work: you connect once, and the provider handles scheme connectivity across SEPA. Your job becomes a clean request/response integration.
1. Autilizatoricati
Le chiamate avvengono pe HTTPS e sunt autilizatoricate cu un bearer token. Conserva la credenziale cum segreto, mai în client. Per verificatie manuali o a basso volum este disponibile una dashboard, astfel chi nu programma poate verificatie senza scrivere cod.
2. Invia la richiesta
Invia în POST nume e IBAN la begunstigde all'endpoint de Verifică. Includi un tuo id de riferimento pentru riconciliare l'rezultat cu il plată o il record de onboarding a cui appartiene.
Mantienila idempotente
Passa un id esterno stabile a fiecare richiesta astfel i retry nu creano Verifică duplicate e puoi ricondurre una voce de log all'azione originaria.
3. Gestisci i quattro rezultate
Every response maps to a SEPA scheme code, so your branching stays simple:
- MATCH (MTCH) — il nume corrisponde la titolare; procedi cu securitate.
- CLOSE_MATCH (CMTC) — quasi esatto; mostra il nume verificat suggerito e chiedi conferma all'utilizator.
- NO_MATCH (NMTC) — show a clear warning before the payment is confirmed.
- NOT_APPLICABLE (NOAP) — Verifică nu disponibile oră; lascia decidere l'utilizator.
La răspuns riporta de asemenea il BIC a bancă răspunzător e il tempo de procesare, utili pentru monitorizare e log de audit.
4. Riutilizzala ovunque
Deoarece il contract este lo stesso, l'unico endpoint serve a mai scopi: una Verifică în linea în timp ce betalerul rivede un nuovo begunstigde, la Verifică massiva de un file leverancieri e un pre-Verifică dentro un flux de mandat SEPA Direct Debit. RoxPay usa la VoP esattamente astfel — de asemenea cum pre-Verifică obligatoriu înainte de emettere il link de semnare de un mandat SDD.