Een Verification-of-Payee-Anfrage gibt in de Regel een Ergebnis in Echtzeit zuruck, schnell genug, um es vóór de Autorisierung einer overboeking via de Zahler naar zeigen. Doch de VoP ist een Netzwerkaufruf aan een andere bank, en Netze sind niet perfekt zuverlassig. Een antwortende PSP kann langsam sein, een Verbindung kann abbrechen, of een Anfrage kann in einer Warteschlange landen. Een produktionsreife integratie braucht een Plan voor de Antwort, de een paar Sekunden — of een paar Minuten — naar spat kommt.
Why a VoP call can become asynchronous
Het schema definieert een krap antwoordvenster, maar echt verkeer produceert toch randgevallen die u gracieus moet afhandelen in plaats van als harde fouten te behandelen:
- De antwoordende PSP is tijdelijk overbelast en antwoordt net buiten uw synchrone time-out.
- Een vorubergehende Netzfehler lost een Wiederholung aus, de abschliesst, nachdem Uw ursprungliche Anfrage zuruckgekehrt ist.
- U reichen viele controleen in het Stapel een (zum Beispiel een betalingslauf) en sammeln de Ergebnisse ein, hoe u zuruckkommen.
De Webhook-Fluss gestalten
Het schoonste patroon is om elke controle een stabiele identificator te geven, een 'in behandeling'-status terug te geven wanneer het synchrone venster verloopt, en een webhook de uiteindelijke uitkomst te laten leveren.
- 1 Reichen U de Verifizierung een en speichern U ihre Request-ID naar de betaling, de U gleich vornehmen wollen.
- 2 Als er geen antwoord binnen uw synchrone budget komt, toon de betaler een 'in behandeling'-status in plaats van een fout.
- 3 Empfangen U het Endergebnis (Overeenkomst, Teiltreffer, Geen overeenkomst of niet verfugbar) aan Uw Webhook-Endpoint.
- 4 Gleichen U de Webhook-Nutzlast met de gespeicherten Request-ID ab en aktualisieren U de betalingsentscheidung.
Sicher en idempotent van Haus aus
Verifieer de handtekening van elke webhook voordat u die vertrouwt, en maak uw handler idempotent: dezelfde uitkomst kan meer dan eens worden geleverd. Sleutel uw verwerking op de request-ID zodat een dubbele levering nooit twee keer op een betaling werkt.
RoxPay gibt een synchrones Ergebnis zuruck, wann immer es kann, en greift op een signierten Webhook zuruck, wanneer een antwortende PSP langsam ist, sodass Uw Checkout reaktionsfahig en Uw Aufzeichnungen vollstandig bleiben.