Een Verification of Payee-verzoek levert meestal in realtime een uitkomst van de vergelijking op, snel genoeg om die te tonen voordat de betaler een overboeking autoriseert. Maar VoP is een netwerkaanroep naar een andere bank, en netwerken zijn niet perfect betrouwbaar. Een antwoordende PSP kan traag zijn, een verbinding kan wegvallen, of een verzoek kan in een wachtrij belanden. Een integratie van productiekwaliteit heeft een plan nodig voor het antwoord dat een paar seconden - of een paar minuten - te laat binnenkomt.
Waarom een VoP-aanroep asynchroon kan worden
Het schema definieert een krap antwoordvenster, maar echt verkeer produceert toch randgevallen die u netjes moet afhandelen in plaats van ze als harde fouten te behandelen:
- De antwoordende PSP is tijdelijk overbelast en antwoordt net buiten uw synchrone time-out.
- Een tijdelijke netwerkstoring veroorzaakt een nieuwe poging die pas klaar is nadat uw oorspronkelijke verzoek al is teruggekeerd.
- U dient veel controles in één keer in (bijvoorbeeld een betaalrun) en verzamelt de resultaten zodra ze binnenkomen.
De webhook-flow ontwerpen
Het schoonste patroon is om elke controle een stabiele identificator te geven, een status 'in behandeling' terug te geven wanneer het synchrone venster verloopt, en een webhook de definitieve uitkomst te laten leveren.
- 1 Dien de verificatie in en sla het request-ID op bij de betaling die u op het punt staat te doen.
- 2 Komt er geen antwoord binnen uw synchrone budget, toon de betaler dan een status 'in behandeling' in plaats van een fout.
- 3 Ontvang de definitieve uitkomst (Overeenkomst, Bijna overeenkomst, Geen overeenkomst of niet beschikbaar) op uw webhook-endpoint.
- 4 Koppel de payload van de webhook terug aan het opgeslagen request-ID en werk de betaalbeslissing bij.
Standaard veilig en idempotent
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 het request-ID zodat een dubbele levering nooit twee keer op een betaling ingrijpt.
RoxPay geeft een synchroon resultaat terug wanneer dat kan en valt terug op een ondertekende webhook wanneer een antwoordende PSP traag is, zodat uw checkout responsief blijft en uw administratie compleet is.