Majoritatea ghidurilor de integrare VoP se opresc la „trimite un nume și un IBAN, citește rezultatul”. Producția adaugă două probleme: rețelele cad și clienții reîncearcă, iar mai târziu finanțele întreabă „de care plată aparținea această verificare?”. Un singur câmp - un external id stabil pentru fiecare cerere - le rezolvă pe amândouă.
Idempotență la reîncercări
Dacă o cerere expiră, clientul tău o poate reîncerca. Fără o cheie de idempotență, aceasta este o a doua verificare - cost suplimentar și jurnale confuze. Atașarea aceluiași external id la reîncercare permite sistemului să o recunoască drept aceeași cerere logică, astfel încât reîncercările sunt sigure.
Un id, generat o singură dată
Generează external id-ul când creezi intenția de plată, nu pentru fiecare încercare HTTP. Astfel, fiecare reîncercare a aceleiași verificări logice poartă același id.
Reconciliere
Același external id este cheia ta de corelare. Stochează-l în înregistrarea plății, trimite-l împreună cu verificarea și vei putea asocia ulterior rezultatul verificării plății exacte - esențial pentru dispute, audituri și analize.
Construiește pista de audit
- 1 Generează un external id pentru fiecare verificare și persistă-l împreună cu plata ta.
- 2 Trimite-l în cerere; refolosește-l la orice reîncercare.
- 3 Înregistrează id-ul de verificare returnat, rezultatul și BIC-ul care a răspuns, asociate cu acesta.
API-ul Verification of Payee de la RoxPay acceptă un external id pentru fiecare cerere și returnează propriul id de verificare împreună cu BIC-ul care a răspuns, astfel încât idempotența și reconcilierea decurg dintr-un singur tipar curat.