Verification of Payee este simplă din punct de vedere conceptual: întrebi dacă un nume corespunde unui IBAN și primești înapoi un rezultat standardizat. Dar o integrare solidă depinde de înțelegerea fiecărei părți a acestui schimb și de alimentarea ei cu date curate.
Partea de cerere
- Numele beneficiarului: numele așa cum te aștepți să fie, ideal structurat și curat.
- IBAN: contul care este verificat.
- Tipul de cont: dacă beneficiarul este o persoană sau o organizație, ceea ce influențează potrivirea.
- O referință de cerere sau o cheie de idempotență pentru a lega apelul de înregistrările tale.
Partea de răspuns
- Rezultat: potrivire, potrivire parțială, fără potrivire sau indisponibil.
- Pentru o potrivire parțială, numele deținut efectiv, ca să îl poți arăta plătitorului.
- Un cod de motiv sau de stare care oferă context pentru rezultat.
- Un identificator pentru a corela cu jurnalele și reconcilierea ta.
Date proaste la intrare, potrivire slabă la ieșire
Acuratețea potrivirii depinde de calitatea datelor de intrare. Trimiterea unor nume curate și bine structurate și a tipului de cont corect îmbunătățește semnificativ rezultatele.
Proiectarea în jurul modelului
API-ul Verification of Payee de la RoxPay expune un model clar de cerere/răspuns, cu rezultate standardizate și detalii suplimentare, astfel încât integrarea ta să poată acționa cu încredere pe baza rezultatelor.