Większość przewodników integracji VoP kończy się na „wyślij nazwę i numer IBAN, odczytaj wynik”. Środowisko produkcyjne dodaje dwa problemy: sieci zawodzą i klienci powtarzają żądania, a później dział finansów pyta „do jakiej płatności należała ta weryfikacja?”. Jedno pole - stabilny external id na żądanie - rozwiązuje obie te sprawy.
Idempotentność przy ponownych próbach
Jeśli żądanie przekroczy czas oczekiwania, Twój klient może je powtórzyć. Bez klucza idempotentności to druga weryfikacja - dodatkowy koszt i mylące logi. Dołączenie tego samego external id do ponownej próby pozwala systemowi rozpoznać ją jako to samo logiczne żądanie, dzięki czemu ponowne próby są bezpieczne.
Jeden identyfikator, wygenerowany raz
Generuj external id w momencie utworzenia intencji płatności, a nie przy każdej próbie HTTP. Dzięki temu każda ponowna próba tej samej logicznej weryfikacji ma ten sam identyfikator.
Uzgadnianie
Ten sam external id jest Twoim kluczem korelacji. Zapisz go w rekordzie płatności, wyślij wraz z weryfikacją, a później będziesz mógł połączyć wynik weryfikacji z konkretną płatnością - to niezbędne przy sporach, audytach i analityce.
Zbuduj ślad audytowy
- 1 Generuj external id dla każdej weryfikacji i zapisuj go wraz z płatnością.
- 2 Wysyłaj go w żądaniu; używaj go ponownie przy każdej próbie powtórnej.
- 3 Rejestruj zwrócony identyfikator weryfikacji, wynik i odpowiadający BIC przy tym identyfikatorze.
API Verification of Payee od RoxPay przyjmuje external id dla każdego żądania i zwraca własny identyfikator weryfikacji wraz z odpowiadającym BIC, dzięki czemu idempotentność i uzgadnianie wynikają z jednego przejrzystego wzorca.