A Verification of Payee nulláról történő felépítése azt jelenti, hogy minden válaszoló PSP-vel integrálni kell, és minden választ normalizálni kell. A VoP API ezt a munkát megszünteti: egyszer kapcsolódik, és a szolgáltató kezeli a séma-kapcsolatot az egész SEPA-n. Az Ön feladata egy tiszta kérés/válasz integráció lesz.
1. Hitelesítés
A hívások HTTPS-en keresztül, bearer tokennel hitelesítve történnek. A hitelesítő adatot titokként tárolja, soha ne a kliensben. Kézi vagy kis volumenű ellenőrzésekhez irányítópult érhető el, így a nem fejlesztők is kód írása nélkül ellenőrizhetnek.
2. A kérés elküldése
POST-tal küldje el a kedvezményezett nevét és IBAN-ját az ellenőrző végpontra. Adjon meg saját hivatkozási azonosítót, hogy az eredményt össze tudja vetni azzal a fizetéssel vagy onboarding rekorddal, amelyhez tartozik.
Tartsa idempotensnek
Minden kéréshez adjon meg egy stabil külső azonosítót, hogy az újrapróbálkozások ne hozzanak létre duplikált ellenőrzéseket, és hogy egy aszinkron naplóbejegyzést vissza tudjon kötni a kiváltó művelethez.
3. A négy eredmény kezelése
Minden válasz egy SEPA séma-kódra képeződik le, így az elágaztatás egyszerű marad:
- MATCH (MTCH) - a név megegyezik a számlatulajdonossal; haladjon tovább magabiztosan.
- CLOSE_MATCH (CMTC) - majdnem pontos; mutassa meg a javasolt ellenőrzött nevet, és kérje meg a felhasználót a megerősítésre.
- NO_MATCH (NMTC) - jelenítsen meg egyértelmű figyelmeztetést a fizetés megerősítése előtt.
- NOT_APPLICABLE (NOAP) - az ellenőrzés jelenleg nem elérhető; hagyja, hogy a felhasználó döntsön.
A válasz tartalmazza a válaszoló bank BIC-kódját és a feldolgozási időt is, amelyek hasznosak a monitorozáshoz és az auditnaplókhoz.
4. Használja újra mindenhol
Mivel a szerződés ugyanaz, az egyetlen végpont több feladatot lát el: soron belüli ellenőrzés, miközben a fizető átnéz egy új kedvezményezettet, egy beszállítói fájl tömeges ellenőrzése, valamint előellenőrzés egy SEPA Direct Debit felhatalmazási folyamatban. A RoxPay pontosan így használja a VoP-t - többek között kötelező előellenőrzésként, mielőtt egy SDD-felhatalmazás aláírási linkjét kiállítanák.