Recupero

I payload inviati al tuo endpoint webhook quando si verificano eventi di recupero carrelli abbandonati o di gestione delle sottoscrizioni.

​

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

payment_id · string · obbligatorio

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

customer_id · string · obbligatorio

Il cliente che ha abbandonato il checkout.

abandonment_reason · string · obbligatorio

Perché il checkout è stato abbandonato. Uno di:

• payment_failed — Il cliente ha tentato il pagamento ma è fallito
• checkout_incomplete — Il cliente ha visitato il checkout ma non ha mai tentato il pagamento

status · string · obbligatorio

Stato attuale del ciclo di vita di questo tentativo di recupero. Uno di:

• abandoned — Rilevato, nessuna email ancora inviata
• recovering — Almeno un’email di recupero inviata
• recovered — Il cliente ha completato il pagamento
• exhausted — Tutte le email inviate o nuovo checkout trovato
• opted_out — Cliente disiscritto

abandoned_at · string · obbligatorio

Timestamp ISO 8601 di quando il checkout è stato rilevato come abbandonato.

recovered_payment_id · string | null

L’ID del pagamento di recupero riuscito. null fino a quando il checkout non viene recuperato.

​

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 Dunning

I seguenti eventi webhook tracciano il ciclo di vita della gestione delle sottoscrizioni:

Evento	Descrizione
dunning.started	È stato creato un tentativo di dunning per una sottoscrizione entrata in on_hold o cancellata dal cliente.
dunning.recovered	Il cliente ha aggiornato il metodo di pagamento e il pagamento risultante è riuscito. Il campo payment_id contiene l’ID del pagamento riuscito.

​

Campi del Payload del Tentativo di Dunning

subscription_id · string · obbligatorio

La sottoscrizione che ha attivato il tentativo di dunning.

customer_id · string · obbligatorio

Il cliente che possiede la sottoscrizione.

trigger_state · string · obbligatorio

Lo stato della sottoscrizione che ha attivato il dunning. Uno di:

• on_hold — Sottoscrizione sospesa a causa di un fallimento del pagamento
• cancelled — Cliente cancellato dal portale clienti

status · string · obbligatorio

Stato attuale del ciclo di vita di questo tentativo di dunning. Uno di:

• recovering — Le email di dunning sono in invio
• recovered — Il cliente ha aggiornato il metodo di pagamento e il pagamento è riuscito
• exhausted — Tutte le email inviate o lo stato della sottoscrizione è cambiato

created_at · string · obbligatorio

Timestamp ISO 8601 di quando il tentativo di dunning è stato creato.

payment_id · string | null

L’ID del pagamento di recupero riuscito. null durante il recupero.

​

Esempio: Gestione dei Webhook 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 });
});

Iscriviti a dunning.started e dunning.recovered per tracciare l’intero ciclo di vita del dunning. Utilizza dunning.started per sospendere i periodi di grazia o segnalare sottoscrizioni a rischio nel tuo sistema.

Abandoned Cart Recovery

Configura sequenze email ACR e incentivi scontati.

Subscription Dunning

Configura sequenze email di dunning per le sottoscrizioni scadute.

Subscription Webhooks

Eventi del ciclo di vita delle sottoscrizioni correlati come subscription.on_hold e subscription.cancelled.

​

Schema del Payload del 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

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