Bronnen · 47

Onzekere betalingen: herstel de checkout zonder dubbele bestellingen

Stem netwerkvertragingen, browserretouren, meldingen en bedrijfsstatus af in plaats van één signaal als voldoende te beschouwen.

Bijgewerkt · 4 min

Fictief leeg analyselaboratorium met drie messing blokken, blanco wijzerplaat, vellen en bordeauxrode map Redactionele illustratie gegenereerd met AI

Wat deze handleiding helpt bereiken

  • Scheid poging, betaling en bestelling
  • Vertraagde of ontbrekende retouren afhandelen
  • Dubbele meldingen en verzoeken verwijderen
  • Onzekerheid uitleggen zonder gebruikers te vragen opnieuw te betalen

Snelle controle

  • Welke bron bevestigt de betaling?
  • Verandert het sluiten van de browser de bedrijfsstatus?
  • Bereidt een herhaalde gebeurtenis twee bestellingen voor?
  • Worden gebeurtenishandtekeningen gecontroleerd?
  • Hoe vindt de supportafdeling een onzekere bewerking?

Stapsgewijze methode

  1. 1

    De statussen definiëren

    Scheid winkelwagen, poging, autorisatie, bevestigde betaling, bestelling en terugbetaling. Schrijf overgangen, gezaghebbende bron en toegestane acties. Volg de daadwerkelijke provider en betaalmethoden; niet elke methode bevestigt direct.

    Resultaat: toestandsdiagram en zakelijk contract.

  2. 2

    Identificeer de bewerking

    Koppel een poging aan een bestelling en provider-identificaties. Gebruik de gedocumenteerde idempotentieregel voor herhaling van dezelfde bewerking. Een nieuw doel of gewijzigde parameters vereisen een expliciete beslissing in plaats van blind hergebruik van de sleutel.

    Resultaat: stabiele identiteit en herstelregels.

  3. 3

    Verwerk de browserretour

    Toon de status van een servercontrole die geschikt is voor de provider. Een redirect naar een succespagina alleen is geen bewijs van betaling. Houd rekening met een gesloten browser, ontbrekende retour, onderbroken authenticatie en een traag netwerk.

    Resultaat: retourtraject en berichten per status.

  4. 4

    Meldingen verifiëren

    Authenticiteit controleren volgens de documentatie van de provider, de identiteit van de gebeurtenis vastleggen en herhalingen afhandelen zonder dubbele effecten. Gebeurtenissen kunnen te laat of in de verkeerde volgorde plaatsvinden. Indien nodig, het referentieobject ophalen vóór een onomkeerbare overgang.

    Resultaat: geteste handler en traceringen zonder bankgegevens.

  5. 5

    Afwijkingen afstemmen

    Providerbewerkingen, orders en afhandeling vergelijken. Betaald zonder order, order zonder bevestiging, dubbele verwerking en niet-doorgevoerde terugbetalingen isoleren. Elke afwijking een eigenaar en procedure toewijzen; een onzekere kostenpost niet automatisch herhalen.

    Resultaat: afstemmingswachtrij en beslissingen.

  6. 6

    Volledig herstel testen

    In de testmodus van de provider, time-out, duplicatie, vertraagde gebeurtenis, omgekeerde order en ontbrekende retourzending opnieuw afspelen. Eén bedrijfstransactie controleren, klantgegevens corrigeren en zichtbaarheid van ondersteuning garanderen. Idempotentiegegevens verschillen per provider.

    Resultaat: bewijs van niet-dubbeling en implementatiecriteria.

Fictief uitgewerkt voorbeeld

Illustratieve situatie

Voorbeeldsituatie: de betaling is succesvol, maar de klant verliest de verbinding vóór de bevestiging en er komen later twee meldingen binnen.

Beslissing en verwachte bewijs

Eén bestelling is bevestigd. Het herstelproces toont de geverifieerde status en de supportafdeling kan de referentie controleren zonder bankgegevens op te vragen.

Onderscheid de mechanismen

MechanismeDoelVerificatie of beperking
BrowserretourInformeer en hervat de interfaceKan ontbreken of onderbroken zijn
Geverifieerde webhookOntvang een wijziging van de providerstatusKan herhaald, vertraagd of in de verkeerde volgorde zijn
ServerafstemmingVergelijk de betalings- en orderstatusVereist een regel voor het oplossen van discrepanties

Managementindicatoren

IndicatorWat het meetEerste actie
Onzekere statussenBewerkingen niet opgelost binnen de beoogde vertragingControleer de referentiestatus
Dubbele effectenBestellingen of verwerkingen tweemaal uitgevoerdBedrijfsdeduplicatie corrigeren
Gesloten hiatenAfgestemde gevallen met beslissing en bewijsBehandel de oudste en kritieke gevallen

Veelvoorkomende fouten

  • Bevestiging op basis van een succesvolle URL
  • Time-out behandelen als betalingsfout
  • Aannemen dat gebeurtenissen aankomen in volgorde
  • Een betaling herhalen voordat gecontroleerd wordt

Veelgestelde vragen

Betekent een time-out een fout?

Nee. Het betekent dat het antwoord niet binnen de ingestelde vertraging is ontvangen. Controleer de status van de bewerking voordat u een nieuwe aanmaakt.

Is de idempotentie van de provider voldoende?

Nee. Het aanmaken, afhandelen en versturen van meldingen van bestellingen moet ook herhaalde verwerking zonder dubbele gevolgen voor de bedrijfsvoering kunnen verdragen.

Wat moet de gebruiker worden verteld?

Leg uit dat de verificatie nog gaande is, geef een veilige referentie en een manier om de status op te vragen. Vermijd het aanvragen van een nieuwe betaling terwijl de vorige nog onzeker is.

Welk bewijs maakt een controle bruikbaar?

Bewaar niet-gevoelige identificaties, toestanden en bewijs van één zakelijk effect. Koppel herhalen aan het API-contract, niet alleen aan een timeout.

Webhooks: handtekening en herhaling

De uitgebreide toelichtingen zijn in deze editie beschikbaar in het Engels.

A payment notification does not close reconciliation by itself

Authenticate each webhook, bind it to the right account and compare its effect with authorised server state. A repeated event must not repeat an initial activation; missing events must remain detectable.

  • Separate notification identity from the operation to perform.
  • Test overlapping manual resend and automatic retry.
  • Retain uncertainty after an unknown external result and check the source before retrying.

See webhook signatures, digests and the ten cases →

Sources reviewed on · Stripe · Webhooks · Stripe · Manage webhook endpoints · GitHub · Validating webhook deliveries · GitHub · Best practices for using webhooks · GitHub · Handling failed webhook deliveries

API-bedragprecisie en exacte eenheden

De uitgebreide toelichtingen zijn in deze editie beschikbaar in het Engels.

Separate exact conversion from payment confirmation

An interface can display the correct price while preparing an incorrect provider integer. Acceptance must reconcile the server amount with the operation contract, then check confirmed state without mistaking arithmetic for completed payment.

  • Test zero-, two- and three-decimal currencies.
  • Include a case where step cannot be inferred from decimals.
  • Retain an exact reference before localised formatting.

Check a unit in the workshop →

Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06

Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06

Officiële referenties

Referenties ondersteunen de methode. Pas controles aan uw context aan; ze zijn geen certificering. Originele referentietitels en brondocumenten kunnen in een andere taal zijn.

Bronnen geraadpleegd op .