Webhookintegraties hebben regels voor herhalingen nodig

Wie een webhookintegratie plant, moet herhaalde afleveringen als een mogelijke bedrijfssituatie behandelen. Bij de softwarekeuze telt wat er met de bedrijfsactie gebeurt wanneer een bericht voor de tweede keer binnenkomt. Een betrouwbare verbinding alleen beantwoordt die vraag niet.

Een verloren signaal laat de uitkomst onzeker

In een fictief klantportaal start een melding de orderaanmaak in het ERP. De order wordt aangemaakt, maar het antwoord bereikt de afzender niet. Die verstuurt de melding opnieuw. Als elke ontvangst blind een nieuwe order aanmaakt, ontstaan twee orders uit dezelfde bedoelde actie.

Stripe vermeldt uitdrukkelijk dat gebeurtenissen meerdere keren kunnen worden afgeleverd. Dat onderbouwt een concreet geval bij een aanbieder. Welke herhalingen uw eigen verbinding kan veroorzaken, moet u aan de hand van het contract ervan controleren. Uit een ontbrekend ontvangstsignaal volgt geen zeker succes en evenmin een zekere mislukking.

Beoordeel de herhaling op het zakelijke effect

De gewenste regel in het voorbeeld is dat dezelfde melding de bestaande order kan terugvinden in plaats van een extra order aan te maken. De integratie heeft een afgesproken identiteit en een betrouwbare koppeling met het verwerkingsresultaat nodig. De bescherming moet ook rekening houden met twee kopieën die tegelijk binnenkomen; losstaande stappen van controleren en later opslaan laten die vraag open.

Controleer in het acceptatiescenario de order in het ERP, het antwoord op de nieuwe poging en de zichtbare status in het portaal. Een transportbevestiging en een afgeronde order kunnen verschillende toestanden zijn.

De inspanning hangt van de actie af

Als een melding alleen een weergegeven waarde opnieuw op dezelfde waarde zet, kan herhaling onschadelijk zijn. Orderaanmaak of een ander effect dat eenmaal bedoeld is, vraagt meer bescherming. Dat verplicht niet om elke kleine verbinding van een extra wachtrij te voorzien.

Herhalingen moeten zichtbaar blijven. Een toename kan op een storing wijzen. Wij adviseren verwachte herhalingen af te handelen en tegelijk ongebruikelijke patronen te kunnen onderzoeken.

Bronnen

• Stripe: Webhooks, duplicate events