Skip to main content
Subscription Dunning mengirim email kepada pelanggan yang subscription-nya kedaluwarsa setelah pembayaran gagal, atau yang membatalkannya, lalu meminta mereka memperbarui metode pembayaran atau membeli kembali. Fitur ini berjalan secara otomatis setelah diaktifkan.

Apa Itu Subscription Dunning?

Dunning mendeteksi saat subscription memasuki status yang dapat dipulihkan dan mengirim rangkaian email yang meminta pelanggan mengambil tindakan. Tiga status dapat memulai rangkaian:
  • Subscription On Hold: Pembayaran perpanjangan gagal, misalnya karena dana tidak mencukupi atau kartu kedaluwarsa.
  • Subscription Past Due: Pembayaran perpanjangan gagal saat grace period masih terbuka.
  • Subscription Cancelled: Pelanggan membatalkannya dari Customer Portal.

Cara Kerja Dunning

1

Trigger

Subscription memasuki salah satu dari tiga status berikut:
  • On Hold: Pembayaran perpanjangan gagal.
  • Past Due: Pembayaran perpanjangan gagal saat grace period masih terbuka.
  • Cancelled: Pelanggan membatalkan subscription mereka dari Customer Portal.
Dodo Payments kemudian membuat upaya dunning dan mengirim webhook dunning.started. Tidak ada upaya yang dimulai jika rangkaian yang sesuai tidak memiliki email yang diaktifkan, dan sebuah subscription hanya dapat memiliki paling banyak satu upaya aktif pada satu waktu.
2

Grace Period

Jika Anda menetapkan grace period, perpanjangan yang gagal akan memindahkan subscription ke past_due, bukan ke on_hold.Rangkaian email on-hold berjalan selama periode tersebut, sehingga pelanggan diminta membayar saat mereka masih memiliki akses.Satu pembayaran yang gagal memulai satu rangkaian. Berakhirnya periode tersebut tidak memulai rangkaian kedua. Jika periode berakhir saat subscription berstatus on hold, sisa email dalam rangkaian tetap dikirim. Jika berakhir saat subscription dibatalkan, upaya tersebut ditandai sebagai exhausted.Upaya dunning mencatat status pemicu past_due. Saat membaca analitik dunning, filter berdasarkan past_due serta on_hold.
3

Email Sequence

Berdasarkan status pemicu, Dodo Payments mengirim hingga 4 email dunning pada jeda yang Anda konfigurasi. Setiap email tertaut ke Customer Portal, tempat pelanggan dapat memperbarui metode pembayaran, atau ke checkout tempat mereka dapat membeli kembali subscription yang dibatalkan.
4

Recovery

Saat pelanggan memperbarui metode pembayaran di Customer Portal, Dodo Payments secara otomatis menagih sisa kewajiban. Jika pembayaran berhasil, subscription diaktifkan kembali dan upaya dunning ditandai sebagai recovered.

Siklus Hidup Status

Setiap upaya dunning memiliki salah satu status berikut:
Saat upaya dunning ditandai sebagai exhausted, Dodo Payments tidak mengubah subscription. Subscription tetap berada dalam status saat ini (past due, on hold, atau cancelled).

Mengonfigurasi Dunning

Aktifkan dan konfigurasikan Dunning di Settings → Recovery pada dashboard Anda. Dunning dinonaktifkan secara default.
Halaman pengaturan Dunning dengan toggle pengaktifan, empat email on-hold pada interval 1, 3, 5, dan 7 hari, serta empat email cancelled pada interval yang sama

Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence

Rangkaian Email

Dunning memiliki dua rangkaian email, On Hold dan Cancelled, masing-masing hingga 4 email. Dashboard mencantumkannya sebagai Emails sent to customer when subscription is on hold dan Emails sent to customer when subscription is cancelled. Upaya past_due menggunakan rangkaian On Hold. Setiap email memiliki pengaturan berikut: Di Subject Line, Dodo Payments mengganti placeholder berikut: {store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason}, dan {payment_form_link}. Jeda default adalah:

Contoh Email Dunning

Dunning mengirim email yang berbeda untuk setiap status subscription. Contoh-contoh ini menunjukkan apa yang dilihat pelanggan.
Email Dunning untuk subscription on-hold yang menampilkan nama toko, pesan tentang pembayaran yang gagal, detail subscription dengan paket dan jumlah, serta tombol Update Payment Method

Dunning email sent when a renewal payment fails and the subscription is on hold

Pengalaman Pemulihan Pelanggan

Saat pelanggan mengeklik tautan dalam email dunning on-hold, Customer Portal terbuka pada subscription mereka. Di sana mereka dapat melihat status subscription dan memperbarui metode pembayaran.
Customer Portal yang menampilkan subscription on-hold untuk Pro Plan seharga $95.00/tahun dengan tombol Update payment method dan banner peringatan tentang pembayaran yang gagal

Customer portal showing an on-hold subscription with option to update payment method

Setelah pelanggan memperbarui metode pembayaran, Dodo Payments menagih semua kewajiban yang belum dibayar. Jika pembayaran berhasil, subscription kembali ke active. Untuk subscription yang dibatalkan, tautan membuka halaman checkout dengan produk subscription tersebut sudah berada di keranjang.

Analitik

Pantau performa Dunning di Analytics → Recovery pada dashboard Anda.
Dashboard analitik Recovery yang menampilkan jumlah masuk dunning, tingkat keberhasilan, pendapatan yang dipulihkan, dan perincian performa per email

Recovery analytics dashboard showing ACR and dunning metrics

Bagian Dunning menampilkan metrik berikut:

Event Webhook

Dunning mengirim dua event webhook:

Recovery Webhook Payloads

Lihat skema payload webhook lengkap untuk event dunning.

Kasus Khusus

Dunning menangani kasus-kasus berikut secara otomatis:

Praktik Terbaik

  • Mulai dengan default: Jeda default (1, 3, 5, dan 7 hari) menyebarkan email selama seminggu, sehingga pelanggan tidak dibanjiri email tetapi tetap menerima pengingat secara berkala.
  • Pantau tingkat pemulihan: Periksa Recovery rate by email untuk melihat email mana yang menghasilkan pemulihan terbanyak. Jika email-email berikutnya hampir tidak menghasilkan pemulihan, nonaktifkan email tersebut.
  • Berkoordinasi dengan support: Beri tahu tim support bahwa email dunning sedang dikirim agar mereka dapat membantu pelanggan yang membalas.
  • Tinjau status subscription: Padukan dunning dengan webhook subscription.on_hold dan subscription.cancelled untuk melacak seluruh siklus hidup subscription.
Dunning bekerja bersama alur on-hold dan reaktivasi yang sudah ada di Customer Portal. Setelah diaktifkan, fitur ini berjalan secara otomatis tanpa pekerjaan integrasi.

Terkait

Recovery Webhooks

Tanggapi event dunning.started dan dunning.recovered.

Abandoned Cart Recovery

Pulihkan checkout yang ditinggalkan atau gagal dengan email pemulihan.

Customer Portal

Pelanggan memperbarui metode pembayaran mereka di Customer Portal.

Subscriptions

Status subscription yang memicu dunning.
Terakhir diubah pada 26 September 2026