Recupero

Eventi di Recupero del Carrello Abbandonato

I seguenti eventi webhook tracciano il ciclo di vita del recupero del carrello abbandonato:

Evento	Descrizione
`abandoned_checkout.detected`	È stato rilevato un checkout abbandonato. Inviato quando un pagamento viene identificato come abbandonato (fallito o incompleto) e inizia il flusso di lavoro di recupero.
`abandoned_checkout.recovered`	Il cliente ha completato il pagamento tramite il link di recupero. Il campo `recovered_payment_id` contiene l’ID del pagamento riuscito.

Campi del Payload del Checkout Abbandonato

string

obbligatorio

Il pagamento originale che è stato abbandonato. Usalo per cercare i dettagli del prodotto, importo e valuta.

string

obbligatorio

Il brand a cui appartiene questo checkout abbandonato.

string

obbligatorio

Il cliente che ha abbandonato il checkout.

string

obbligatorio

Il motivo per cui il checkout è stato abbandonato. Uno tra:

payment_failed — Il cliente ha tentato di effettuare il pagamento, ma non è riuscito
checkout_incomplete — Il cliente ha visitato il checkout, ma non ha mai tentato di effettuare il pagamento

string

obbligatorio

Stato attuale del lifecycle di questo tentativo di recupero. Uno tra:

abandoned — Rilevato, nessuna email ancora inviata
recovering — Almeno un’email di recupero inviata
recovered — Il cliente ha completato il pagamento
exhausted — Tutte le email sono state inviate oppure è stato trovato un checkout più recente
opted_out — Il cliente ha annullato l’iscrizione

string

obbligatorio

Timestamp ISO 8601 del momento in cui il checkout è stato rilevato come abbandonato.

string | null

L’ID del pagamento di recupero completato correttamente. null fino al recupero del checkout.

Esempio: gestione dei webhook ACR

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 });
});

Eventi di dunning

I seguenti eventi webhook tengono traccia del lifecycle di dunning dell’abbonamento:

Evento	Descrizione
`dunning.started`	È stato creato un tentativo di dunning per un abbonamento che è entrato nello stato `on_hold` o che è stato annullato dal cliente.
`dunning.recovered`	Il cliente ha aggiornato il metodo di pagamento e il pagamento risultante è andato a buon fine. Il campo `payment_id` contiene l’ID del pagamento completato correttamente.

Campi del payload del tentativo di dunning

string

obbligatorio

L’abbonamento che ha attivato il tentativo di dunning.

string

obbligatorio

Il brand a cui appartiene questo tentativo di dunning.

string

obbligatorio

Il cliente proprietario dell’abbonamento.

string

obbligatorio

Lo stato dell’abbonamento che ha attivato il dunning. Uno di:

on_hold — Rinnovi interrotti a causa di un mancato pagamento
cancelled — Il cliente ha annullato l’abbonamento dal Customer Portal

string

obbligatorio

Stato attuale del lifecycle di questo tentativo di dunning. Uno tra:

recovering — Le email di dunning sono in fase di invio
recovered — Il cliente ha aggiornato il metodo di pagamento e il pagamento è andato a buon fine
exhausted — Tutte le email sono state inviate oppure lo stato dell’abbonamento è cambiato

string

obbligatorio

Timestamp ISO 8601 del momento in cui è stato creato il tentativo di dunning.

string | null

L’ID del pagamento di recupero completato correttamente. null durante il recupero.

Esempio: gestione dei webhook di dunning

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 });
});

Sottoscrivi entrambi dunning.started e dunning.recovered per tenere traccia dell’intero lifecycle di dunning. Usa dunning.started per sospendere i periodi di tolleranza o contrassegnare nel tuo sistema gli abbonamenti a rischio.

Abandoned Cart Recovery

Configura le sequenze di email ACR e gli incentivi sotto forma di sconto.

Subscription Dunning

Configura le sequenze di email di dunning per gli abbonamenti scaduti.

Subscription Webhooks

Eventi correlati del lifecycle dell’abbonamento, come subscription.on_hold e subscription.cancelled.

Schema del payload webhook

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

abandoned_at

string<date-time>

obbligatorio

abandonment_reason

enum<string>

obbligatorio

Opzioni disponibili:

payment_failed,

checkout_incomplete

brand_id

string

obbligatorio

Brand id this abandoned checkout belongs to

customer_id

string

obbligatorio

payment_id

string

obbligatorio

status

enum<string>

obbligatorio

Opzioni disponibili:

abandoned,

recovering,

recovered,

exhausted,

opted_out

recovered_payment_id

string | null

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Eventi di Recupero del Carrello Abbandonato

Campi del Payload del Checkout Abbandonato

Esempio: gestione dei webhook ACR

Eventi di dunning

Campi del payload del tentativo di dunning

Esempio: gestione dei webhook di dunning

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

Schema del payload webhook

​Eventi di Recupero del Carrello Abbandonato

​Campi del Payload del Checkout Abbandonato

​Esempio: gestione dei webhook ACR

​Eventi di dunning

​Campi del payload del tentativo di dunning

​Esempio: gestione dei webhook di dunning

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

​Schema del payload webhook

Eventi di Recupero del Carrello Abbandonato

Campi del Payload del Checkout Abbandonato

Esempio: gestione dei webhook ACR

Eventi di dunning

Campi del payload del tentativo di dunning

Esempio: gestione dei webhook di dunning

Schema del payload webhook