Hoppa till huvudinnehåll

​
Övergivna varukorgsåterställningshändelser

Följande webhook-händelser spårar livscykeln för övergiven varukorgsåterställning:
HändelseBeskrivning
abandoned_checkout.detectedEn övergiven utcheckning har upptäckts. Skickas när en betalning identifieras som övergiven (misslyckad eller ofullständig) och återställningsarbetsflödet börjar.
abandoned_checkout.recoveredKunden slutförde betalningen via återställningslänken. Fältet recovered_payment_id innehåller det lyckade betalnings-ID:t.

​
Fält för övergiven utcheckningsnyttolast

​
payment_id
string
obligatorisk
Den ursprungliga betalningen som övergavs. Använd denna för att leta upp produkt-, belopps- och valutainformation.
​
customer_id
string
obligatorisk
Kunden som övergav utcheckningen.
​
abandonment_reason
string
obligatorisk
Varför utcheckningen övergavs. En av:
  • payment_failed — Kunden försökte att betala men det misslyckades
  • checkout_incomplete — Kunden besökte utcheckningen men försökte aldrig att betala
​
status
string
obligatorisk
Nuvarande livscykeltillstånd för detta återställningsförsök. En av:
  • abandoned — Upptäckt, inga mejl skickade ännu
  • recovering — Minst ett återställningsmejl skickat
  • recovered — Kunden slutförde betalningen
  • exhausted — Alla mejl skickade eller nyare utcheckning hittad
  • opted_out — Kunden avprenumererade
​
abandoned_at
string
obligatorisk
ISO 8601-tidsstämpel för när utcheckningen upptäcktes som övergiven.
​
recovered_payment_id
string | null
Betalnings-ID för den lyckade återställningsbetalningen. null tills utcheckningen återställs.

​
Exempel: Hantering av ACR-webhooks

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'abandoned_checkout.detected':
      console.log(`Checkout abandoned: ${event.data.payment_id}`);
      console.log(`Reason: ${event.data.abandonment_reason}`);
      // Track abandonment in your analytics
      await trackAbandonment(event.data);
      break;

    case 'abandoned_checkout.recovered':
      console.log(`Checkout recovered: ${event.data.payment_id}`);
      console.log(`Recovery payment: ${event.data.recovered_payment_id}`);
      // Grant access, update records
      await handleRecovery(event.data);
      break;
  }

  res.json({ received: true });
});

​
Förnyelsehändelser

Följande webhook-händelser spårar livscykeln för abonnemangsförnyelse:
HändelseBeskrivning
dunning.startedEtt försök till förnyelse har skapats för ett abonnemang som har gått in i on_hold eller avbrutits av kunden.
dunning.recoveredKunden uppdaterade sin betalningsmetod och den resulterande betalningen lyckades. Fältet payment_id innehåller det lyckade betalnings-ID:t.

​
Fält för nyttolast om förnyelseförsök

​
subscription_id
string
obligatorisk
Abonnemanget som utlöste förnyelseförsöket.
​
customer_id
string
obligatorisk
Kunden som äger abonnemanget.
​
trigger_state
string
obligatorisk
Abonnemangstillståndet som utlöste förnyelse. En av:
  • on_hold — Abonnemanget pausades på grund av betalningsfel
  • cancelled — Kunden avbröt från kundportalen
​
status
string
obligatorisk
Nuvarande livscykeltillstånd för detta förnyelseförsök. En av:
  • recovering — Förnyelsemejl skickas
  • recovered — Kunden uppdaterade betalningsmetod och betalningen lyckades
  • exhausted — Alla mejl skickade eller abonnemangstillstånd ändrat
​
created_at
string
obligatorisk
ISO 8601-tidsstämpel för när förnyelseförsöket skapades.
​
payment_id
string | null
Betalnings-ID för den lyckade återställningsbetalningen. null under återställning.

​
Exempel: Hantering av förnyelse-webhooks

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'dunning.started':
      console.log(`Dunning started for subscription: ${event.data.subscription_id}`);
      console.log(`Trigger: ${event.data.trigger_state}`);
      // Track dunning in your system
      await trackDunning(event.data);
      break;

    case 'dunning.recovered':
      console.log(`Subscription recovered: ${event.data.subscription_id}`);
      console.log(`Recovery payment: ${event.data.payment_id}`);
      // Reactivate access, update records
      await handleDunningRecovery(event.data);
      break;
  }

  res.json({ received: true });
});
Prenumerera på både dunning.started och dunning.recovered för att spåra hela förnyelselivscykeln. Använd dunning.started för att pausa fristperioder eller markera abonnemang som är riskerade i ditt system.

Abandoned Cart Recovery

Konfigurera ACR e-postsekvenser och rabattincitament.

Subscription Dunning

Konfigurera förnyelse-e-postsekvenser för förfallna abonnemang.

Subscription Webhooks

Relaterade abonnemangslivscykelhändelser som subscription.on_hold och subscription.cancelled.

​
Schema för webhook-nyttolast

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

​
abandoned_at
string<date-time>
obligatorisk
​
abandonment_reason
enum<string>
obligatorisk
Tillgängliga alternativ:
payment_failed,
checkout_incomplete
​
customer_id
string
obligatorisk
​
payment_id
string
obligatorisk
​
status
enum<string>
obligatorisk
Tillgängliga alternativ:
abandoned,
recovering,
recovered,
exhausted,
opted_out
​
recovered_payment_id
string | null
Last modified on April 20, 2026