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

Varumärket som denna övergivna checkout tillhör.

string

obligatorisk

Kunden som övergav checkouten.

string

obligatorisk

Varför checkouten övergavs. Ett av följande:

payment_failed — Kunden försökte genomföra betalningen, men den misslyckades
checkout_incomplete — Kunden besökte checkouten men försökte aldrig genomföra betalningen

string

obligatorisk

Aktuellt livscykeltillstånd för detta återställningsförsök. Ett av följande:

abandoned — Identifierad, inga e-postmeddelanden har skickats ännu
recovering — Minst ett återställningsmeddelande har skickats
recovered — Kunden har slutfört betalningen
exhausted — Alla e-postmeddelanden har skickats eller en nyare checkout har hittats
opted_out — Kunden har avslutat prenumerationen

string

obligatorisk

ISO 8601-tidsstämpel för när checkouten identifierades som övergiven.

string | null

Betalnings-ID:t för den lyckade återställningsbetalningen. null tills checkouten har återställts.

Exempel: Hantera 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 });
});

Dunning-händelser

Följande webhook-händelser spårar prenumerationens Dunning-livscykel:

Händelse	Beskrivning
`dunning.started`	Ett Dunning-försök har skapats för en prenumeration som övergick till `on_hold` eller avslutades av kunden.
`dunning.recovered`	Kunden uppdaterade sin betalningsmetod och den resulterande betalningen lyckades. Fältet `payment_id` innehåller ID:t för den lyckade betalningen.

Fält i nyttolasten för Dunning-försök

string

obligatorisk

Prenumerationen som utlöste Dunning-försöket.

string

obligatorisk

Varumärket som detta Dunning-försök tillhör.

string

obligatorisk

Kunden som äger prenumerationen.

string

obligatorisk

Prenumerationsstatusen som utlöste dunning. En av:

on_hold — Förnyelser stoppades på grund av ett betalningsfel
cancelled — Kunden avslutade prenumerationen från Customer Portal

string

obligatorisk

Aktuellt livscykeltillstånd för detta Dunning-försök. Ett av följande:

recovering — Dunning-e-postmeddelanden skickas
recovered — Kunden uppdaterade betalningsmetoden och betalningen lyckades
exhausted — Alla e-postmeddelanden har skickats eller prenumerationens tillstånd har ändrats

string

obligatorisk

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

string | null

Betalnings-ID:t för den lyckade återställningsbetalningen. null under återställningen.

Exempel: Hantera Dunning-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 Dunning-livscykeln. Använd dunning.started för att pausa respitperioder eller markera prenumerationer i riskzonen i ditt system.

Abandoned Cart Recovery

Konfigurera ACR-e-postsekvenser och rabattincitament.

Subscription Dunning

Konfigurera Dunning-e-postsekvenser för förfallna prenumerationer.

Subscription Webhooks

Relaterade händelser i prenumerationens livscykel, så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: Hantera ACR-webhooks

Dunning-händelser

Fält i nyttolasten för Dunning-försök

Exempel: Hantera Dunning-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: Hantera ACR-webhooks

​Dunning-händelser

​Fält i nyttolasten för Dunning-försök

​Exempel: Hantera Dunning-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: Hantera ACR-webhooks

Dunning-händelser

Fält i nyttolasten för Dunning-försök

Exempel: Hantera Dunning-webhooks

Schema för webhook-nyttolast