Pemulihan

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

string

wajib

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

string

wajib

Brand tempat checkout yang ditinggalkan ini berada.

string

wajib

Customer yang meninggalkan checkout.

string

wajib

Alasan checkout ditinggalkan. Salah satu dari:

payment_failed — Customer mencoba melakukan payment, tetapi gagal
checkout_incomplete — Customer mengunjungi checkout, tetapi tidak pernah mencoba melakukan payment

string

wajib

Status lifecycle saat ini dari upaya recovery ini. Salah satu dari:

abandoned — Terdeteksi, belum ada email yang dikirim
recovering — Setidaknya satu email recovery telah dikirim
recovered — Customer menyelesaikan payment
exhausted — Semua email telah dikirim atau checkout yang lebih baru ditemukan
opted_out — Customer berhenti berlangganan

string

wajib

Timestamp ISO 8601 saat checkout terdeteksi sebagai checkout yang ditinggalkan.

string | null

ID payment dari payment recovery yang berhasil. null hingga checkout berhasil 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 });
});

Event Dunning

Event webhook berikut melacak lifecycle dunning subscription:

Event	Deskripsi
`dunning.started`	Upaya dunning telah dibuat untuk subscription yang memasuki `on_hold` atau dibatalkan oleh customer.
`dunning.recovered`	Customer memperbarui payment method mereka dan payment yang dihasilkan berhasil. Field `payment_id` berisi ID payment yang berhasil.

Field Payload Dunning

string

wajib

Subscription yang memicu upaya dunning.

string

wajib

Brand tempat upaya dunning ini berada.

string

wajib

Customer yang memiliki subscription.

string

wajib

Status subscription yang memicu dunning. Salah satu dari:

on_hold — Subscription dijeda karena payment gagal
cancelled — Customer membatalkan dari customer portal

string

wajib

Status lifecycle saat ini dari upaya dunning ini. Salah satu dari:

recovering — Email dunning sedang dikirim
recovered — Customer memperbarui payment method dan payment berhasil
exhausted — Semua email telah dikirim atau status subscription berubah

string

wajib

Timestamp ISO 8601 saat upaya dunning dibuat.

string | null

ID payment dari payment recovery yang berhasil. null selama proses recovery.

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 seluruh lifecycle dunning. Gunakan dunning.started untuk menjeda masa tenggang atau menandai subscription berisiko di sistem Anda.

Abandoned Cart Recovery

Konfigurasikan rangkaian email ACR dan insentif diskon.

Subscription Dunning

Konfigurasikan rangkaian email dunning untuk subscription yang telah kedaluwarsa.

Subscription Webhooks

Event lifecycle subscription 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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Peristiwa Pemulihan Keranjang yang Ditinggalkan

Bidang Payload Checkout yang Ditinggalkan

Contoh: Menangani Webhook ACR

Event Dunning

Field Payload Dunning

Contoh: Menangani Webhook Dunning

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

Skema Payload Webhook

​Peristiwa Pemulihan Keranjang yang Ditinggalkan

​Bidang Payload Checkout yang Ditinggalkan

​Contoh: Menangani Webhook ACR

​Event Dunning

​Field Payload Dunning

​Contoh: Menangani Webhook Dunning

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

​Skema Payload Webhook

Peristiwa Pemulihan Keranjang yang Ditinggalkan

Bidang Payload Checkout yang Ditinggalkan

Contoh: Menangani Webhook ACR

Event Dunning

Field Payload Dunning

Contoh: Menangani Webhook Dunning

Skema Payload Webhook