> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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
Den ursprungliga betalningen som övergavs. Använd denna för att leta upp produkt-, belopps- och valutainformation.
Kunden som övergav utcheckningen.
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
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
ISO 8601-tidsstämpel för när utcheckningen upptäcktes som övergiven.
Betalnings-ID för den lyckade återställningsbetalningen. `null` tills utcheckningen återställs.
### Exempel: Hantering av ACR-webhooks
```javascript theme={null}
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
Abonnemanget som utlöste förnyelseförsöket.
Kunden som äger abonnemanget.
Abonnemangstillståndet som utlöste förnyelse. En av:
* `on_hold` — Abonnemanget pausades på grund av betalningsfel
* `cancelled` — Kunden avbröt från kundportalen
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
ISO 8601-tidsstämpel för när förnyelseförsöket skapades.
Betalnings-ID för den lyckade återställningsbetalningen. `null` under återställning.
### Exempel: Hantering av förnyelse-webhooks
```javascript theme={null}
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.
Konfigurera ACR e-postsekvenser och rabattincitament.
Konfigurera förnyelse-e-postsekvenser för förfallna abonnemang.
Relaterade abonnemangslivscykelhändelser som `subscription.on_hold` och `subscription.cancelled`.
## Schema för webhook-nyttolast