Să construiești Verification of Payee de la zero înseamnă să te integrezi cu fiecare PSP care răspunde și să normalizezi fiecare răspuns. Un API VoP elimină această muncă: te conectezi o singură dată, iar furnizorul se ocupă de conectivitatea la schemă în tot spațiul SEPA. Treaba ta devine o integrare curată de tip cerere/răspuns.
1. Autentifică-te
Apelurile se fac prin HTTPS și sunt autentificate cu un bearer token. Păstrează credențialul ca secret, niciodată în client. Pentru verificări manuale sau cu volum mic există un dashboard, astfel încât cei care nu programează să poată verifica fără să scrie cod.
2. Trimite cererea
Trimite prin POST numele și IBAN-ul beneficiarului către endpointul de verificare. Include propriul tău id de referință, ca să poți reconcilia rezultatul cu plata sau cu înregistrarea de onboarding căreia îi aparține.
Menține-o idempotentă
Trimite un id extern stabil la fiecare cerere, astfel încât reîncercările să nu creeze verificări duplicate și să poți asocia o intrare asincronă din log cu acțiunea care a generat-o.
3. Gestionează cele patru rezultate
Fiecare răspuns corespunde unui cod al schemei SEPA, așa că logica ta de ramificare rămâne simplă:
- MATCH (MTCH) — numele corespunde titularului de cont; continuă cu încredere.
- CLOSE_MATCH (CMTC) — aproape corect; afișează numele verificat sugerat și cere utilizatorului să confirme.
- NO_MATCH (NMTC) — afișează un avertisment clar înainte ca plata să fie confirmată.
- NOT_APPLICABLE (NOAP) — verificarea nu este disponibilă acum; lasă utilizatorul să decidă.
Răspunsul conține și BIC-ul băncii care a răspuns și timpul de procesare, utile pentru monitorizare și pentru logurile de audit.
4. Refolosește-o peste tot
Pentru că contractul este același, un singur endpoint servește mai multe scopuri: o verificare în linie în timp ce plătitorul analizează un beneficiar nou, verificarea în lot a unui fișier de furnizori și o pre-verificare în cadrul unui flux de mandat SEPA Direct Debit. RoxPay folosește VoP exact așa — inclusiv ca pre-verificare obligatorie înainte de emiterea unui link de semnare a unui mandat SDD.