Gran parte delle ghiduri all'integrare VoP si ferma a «invia nume e IBAN, legi l'rezultat». La producție aggiunge due probleme: le rețele falliscono e i client riprovano, e în seguito la finanțe chiede «a care plată apparteneva această Verifică?». Un solo câmp — un external id stabile pentru richiesta — se rezolvă ambii.
Idempotenza sui retry
Se una richiesta va în timeout, il tuo client potrebbe riprovarla. Senza una chiave de idempotenza, este una seconda Verifică — cost extra e log confusi. Allegare lo stesso external id la retry permette la sistem de riconoscerlo cum la aceeași richiesta logica, astfel i retry sunt sicuri.
Un id, generato una dată
Genera l'external id când crei l'intento de plată, nu pentru fiecare tentativo HTTP. Così fiecare retry a stessa verificatie logica porta lo stesso id.
Riconciliazione
The same external id is your correlation key. Store it on your payment record, send it with the verification, and you can later join the verification result back to the exact payment — essential for disputes, audits and analytics.
Costruisci la pista de audit
- 1 Genera un external id pentru verificatie e persistilo cu il tuo plată.
- 2 Invialo nella richiesta; riutilizzalo pe fiecare retry.
- 3 Log the returned verification id, outcome and responding BIC against it.
L'API Verification of Payee de RoxPay accetta un external id pentru richiesta e restituisce il proprio verification id cu il BIC rispondente, astfel idempotenza e riconciliazione derivano de la un unico scaremă pulito.