Meer grip op het betaalmoment
010 - 200 59 85
Hulp op afstand
Login

Koppelingen en administratie

Hoe helpt idempotency dubbele betaalverwerking voorkomen?

Met dezelfde sleutel herken je een herhaald API-verzoek; herhaalde webhookmeldingen vragen daarnaast eigen controle.

Bijgewerkt op 6 november 2026

Bij een netwerkfout kan onduidelijk zijn of een API-verzoek is uitgevoerd. Verstuur je daarna een volledig nieuw verzoek, dan kan dezelfde handeling onbedoeld opnieuw plaatsvinden. Idempotency maakt een veilige herhaling mogelijk door een unieke sleutel te koppelen aan de oorspronkelijke opdracht. Stripe documenteert hiervoor idempotency keys. Gebruik bij een herhaling van dezelfde opdracht dezelfde sleutel, binnen de voorwaarden van de betreffende API.

Dit lost niet iedere vorm van dubbele verwerking op. Ook webhookmeldingen kunnen meermaals binnenkomen en moeten bij de ontvangende toepassing worden herkend. Bewaar daarom de relevante opdracht-, transactie- en gebeurtenisreferenties en controleer of de zakelijke handeling al is uitgevoerd. Onderzoek een vermoede dubbele betaling eerst in de providergegevens. Een dubbele melding is niet noodzakelijk een tweede betaling en vraagt dus niet automatisch om een terugbetaling.

Bronnen bij dit antwoord
  1. Idempotent requests Stripe
  2. Receive Stripe events in your webhook endpoint Stripe