Recovery

Ö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

string

obligatorisk

Den ursprungliga betalningen som övergavs. Använd denna för att leta upp produkt-, belopps- och valutainformation.

string

obligatorisk

Kunden som övergav utcheckningen.

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

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

string

obligatorisk

ISO 8601-tidsstämpel för när utcheckningen upptäcktes som övergiven.

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

string

obligatorisk

Abonnemanget som utlöste förnyelseförsöket.

string

obligatorisk

Kunden som äger abonnemanget.

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

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

string

obligatorisk

ISO 8601-tidsstämpel för när förnyelseförsöket skapades.

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

brand_id

string

obligatorisk

Brand id this abandoned checkout belongs to

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Övergivna varukorgsåterställningshändelser

Fält för övergiven utcheckningsnyttolast

Exempel: Hantering av ACR-webhooks

Förnyelsehändelser

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

Exempel: Hantering av förnyelse-webhooks

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

Schema för webhook-nyttolast

​Övergivna varukorgsåterställningshändelser

​Fält för övergiven utcheckningsnyttolast

​Exempel: Hantering av ACR-webhooks

​Förnyelsehändelser

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

​Exempel: Hantering av förnyelse-webhooks

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

​Schema för webhook-nyttolast

Övergivna varukorgsåterställningshändelser

Fält för övergiven utcheckningsnyttolast

Exempel: Hantering av ACR-webhooks

Förnyelsehändelser

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

Exempel: Hantering av förnyelse-webhooks

Schema för webhook-nyttolast