Pemulihan

Payload yang dikirim ke endpoint webhook Anda ketika pemulihan keranjang yang ditinggalkan atau peristiwa dunning langganan terjadi.

​

Peristiwa Pemulihan Keranjang yang Ditinggalkan

Peristiwa webhook berikut melacak siklus hidup pemulihan keranjang yang ditinggalkan:

Peristiwa	Deskripsi
abandoned_checkout.detected	Checkout yang ditinggalkan telah terdeteksi. Dikirim saat pembayaran diidentifikasi sebagai ditinggalkan (gagal atau tidak lengkap) dan alur kerja pemulihan dimulai.
abandoned_checkout.recovered	Pelanggan menyelesaikan pembayaran melalui tautan pemulihan. Kolom recovered_payment_id berisi ID pembayaran yang berhasil.

​

Bidang Payload Checkout yang Ditinggalkan

payment_id · string · wajib

Pembayaran asli yang ditinggalkan. Gunakan ini untuk mencari detail produk, jumlah, dan mata uang.

customer_id · string · wajib

Pelanggan yang meninggalkan checkout.

abandonment_reason · string · wajib

Mengapa checkout ditinggalkan. Salah satu dari:

• payment_failed — Pelanggan mencoba pembayaran tetapi gagal
• checkout_incomplete — Pelanggan mengunjungi checkout tetapi tidak pernah mencoba pembayaran

status · string · wajib

Status siklus hidup saat ini dari upaya pemulihan ini. Salah satu dari:

• abandoned — Terdeteksi, belum ada email yang dikirim
• recovering — Setidaknya satu email pemulihan terkirim
• recovered — Pelanggan menyelesaikan pembayaran
• exhausted — Semua email terkirim atau checkout baru ditemukan
• opted_out — Pelanggan berhenti berlangganan

abandoned_at · string · wajib

Timestamp ISO 8601 ketika checkout terdeteksi sebagai ditinggalkan.

recovered_payment_id · string | null

ID pembayaran dari pembayaran pemulihan yang berhasil. null sampai checkout dipulihkan.

​

Contoh: Menangani 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 });
});

---

​

Peristiwa Dunning

Peristiwa webhook berikut melacak siklus hidup dunning langganan:

Peristiwa	Deskripsi
dunning.started	Percobaan dunning telah dibuat untuk langganan yang masuk ke on_hold atau dibatalkan oleh pelanggan.
dunning.recovered	Pelanggan memperbarui metode pembayaran mereka dan pembayaran yang dihasilkan berhasil. Kolom payment_id berisi ID pembayaran yang berhasil.

​

Bidang Payload Percobaan Dunning

subscription_id · string · wajib

Langganan yang memicu percobaan dunning.

customer_id · string · wajib

Pelanggan yang memiliki langganan.

trigger_state · string · wajib

Status langganan yang memicu dunning. Salah satu dari:

• on_hold — Langganan dijeda karena kegagalan pembayaran
• cancelled — Pelanggan membatalkan dari portal pelanggan

status · string · wajib

Status siklus hidup saat ini dari percobaan dunning ini. Salah satu dari:

• recovering — Email dunning sedang dikirim
• recovered — Pelanggan memperbarui metode pembayaran dan pembayaran berhasil
• exhausted — Semua email terkirim atau status langganan berubah

created_at · string · wajib

Timestamp ISO 8601 ketika percobaan dunning dibuat.

payment_id · string | null

ID pembayaran dari pembayaran pemulihan yang berhasil. null saat pemulihan.

​

Contoh: Menangani 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 });
});

Berlangganan ke dunning.started dan dunning.recovered untuk melacak siklus hidup dunning lengkap. Gunakan dunning.started untuk menjeda periode tenggang atau menandai langganan berisiko dalam sistem Anda.

Abandoned Cart Recovery

Konfigurasi urutan email ACR dan insentif diskon.

Subscription Dunning

Konfigurasi urutan email dunning untuk langganan yang terlewat.

Subscription Webhooks

Peristiwa siklus hidup langganan terkait seperti subscription.on_hold dan subscription.cancelled.

​

Skema Payload Webhook

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

abandoned_at · string<date-time> · wajib

abandonment_reason · enum<string> · wajib

Opsi yang tersedia: payment_failed, checkout_incomplete

brand_id · string · wajib

Brand id this abandoned checkout belongs to

customer_id · string · wajib

payment_id · string · wajib

status · enum<string> · wajib

Opsi yang tersedia: abandoned, recovering, recovered, exhausted, opted_out

recovered_payment_id · string | null