Een Verification of Payee-verzoek geeft meestal een uitkomst in realtime terug, snel genoeg om die te tonen voordat de betaler een overboeking autoriseert. Maar de 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 productiewaardige integratie heeft een plan nodig voor het antwoord dat een paar seconden — of een paar minuten — te laat aankomt.
Waarom een VoP-aanroep asynchroon kan worden
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 tijdelijke netwerkstoring triggert een herhaling die afrondt nadat uw initiële verzoek al terugkeerde.
- U dient veel controles in bulk in (bijvoorbeeld een betaalrun) en verzamelt de resultaten naarmate ze terugkomen.
De webhookflow ontwerpen
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 Dien de verificatie in en sla de request-ID op gekoppeld aan de betaling die u op het punt staat te doen.
- 2 Als er geen antwoord binnen uw synchrone budget komt, toon de betaler een 'in behandeling'-status in plaats van een fout.
- 3 Ontvang de uiteindelijke uitkomst (overeenkomst, gedeeltelijk, geen overeenkomst of niet beschikbaar) op uw webhook-endpoint.
- 4 Stem de webhook-payload af op de opgeslagen request-ID en werk de betaalbeslissing bij.
Veilig en idempotent standaard
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 geeft een synchrone uitkomst terug wanneer het kan en valt terug op een ondertekende webhook wanneer een antwoordende PSP traag is, zodat uw checkout responsief blijft en uw administratie volledig blijft.