Recovery

De nyttolaster som skickas till din webbhook-endpoint när händelser för övergiven varukorgsåterställning eller abonnemangsförnyelse inträffar.

​

Övergivna varukorgsåterställningshändelser

Följande webhook-händelser spårar livscykeln för övergiven varukorgsåterställning:

Händelse	Beskrivning
abandoned_checkout.detected	En ö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.recovered	Kunden 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ändelse	Beskrivning
dunning.started	Ett 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.recovered	Kunden 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