> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Subscription Dunning > Secara otomatis mengirimkan rangkaian email untuk memulihkan langganan yang tertunda atau dibatalkan dengan meminta pelanggan memperbarui metode pembayaran mereka. Subscription Dunning secara otomatis mengirimkan rangkaian email kepada pelanggan yang langganannya tertunda akibat kegagalan pembayaran atau pembatalan oleh pelanggan, meminta mereka untuk memperbarui metode pembayaran dan mengaktifkan kembali. ## Apa Itu Subscription Dunning? Dunning secara otomatis mendeteksi saat langganan memasuki status yang dapat dipulihkan dan mengirimkan rangkaian email yang meminta pelanggan untuk mengambil tindakan: * **Langganan Ditahan**: Pembayaran perpanjangan gagal (dana tidak mencukupi, kartu kedaluwarsa, dll.) * **Langganan Dibatalkan**: Pembatalan dilakukan oleh pelanggan dari portal pelanggan ## Cara Kerja Dunning Dunning dipicu ketika langganan memasuki salah satu dari dua status: * **Ditahan**: Pembayaran perpanjangan gagal (dana tidak mencukupi, kartu kedaluwarsa, dll.) * **Dibatalkan**: Pelanggan membatalkan langganan mereka dari portal pelanggan Berdasarkan status pemicu, sistem mengirim hingga 4 email dunning pada interval yang dikonfigurasikan. Setiap email mencakup tautan ke portal pelanggan tempat pelanggan dapat memperbarui metode pembayaran mereka atau membeli ulang langganan. Ketika pelanggan memperbarui metode pembayaran mereka melalui portal pelanggan, biaya akan otomatis dibuat untuk kewajiban yang tersisa. Jika pembayaran berhasil, langganan diaktifkan kembali dan percobaan dunning ditandai sebagai pulih. ## Siklus Status | Status | Deskripsi | | ------------ | ---------------------------------------------------------------------------------------- | | `recovering` | Percobaan dunning aktif; email sedang dikirim | | `recovered` | Pelanggan memperbarui metode pembayaran dan pembayaran berhasil | | `exhausted` | Semua email terkirim tanpa pemulihan, atau status langganan berubah secara tidak terduga | Ketika percobaan dunning ditandai sebagai `exhausted`, status langganan tidak diubah. Langganan tetap dalam status saat ini (ditahan atau dibatalkan). ## Mengkonfigurasi Dunning Aktifkan dan konfigurasikan Dunning dari **Settings** di dashboard Anda. Halaman pengaturan Dunning dengan sakelar pengaktif, empat email ditahan pada interval 1, 3, 5, dan 7 hari, dan empat email dibatalkan pada interval yang sama ### Rangkaian Email Dunning mendukung dua rangkaian email — **Ditahan** dan **Dibatalkan** — masing-masing dengan hingga 4 email yang dapat dikonfigurasikan. Setiap email memiliki bidang yang dapat dikonfigurasikan berikut: | Pengaturan | Deskripsi | | ------------ | ------------------------------------------------------------------- | | **Enabled** | Mengaktifkan atau menonaktifkan email individual tanpa menghapusnya | | **Delay** | Waktu setelah peristiwa pemicu untuk mengirim email ini | | **Subject** | Baris subjek email dengan placeholder variabel | | **Body** | Isi email HTML dengan placeholder variabel | | **Reply-To** | Alamat email untuk balasan pelanggan | **Waktu pengiriman email default:** | Rangkaian | Email # | Penundaan Default | | ---------- | ------- | ----------------- | | Ditahan | 1 | 1 hari | | Ditahan | 2 | 3 hari | | Ditahan | 3 | 5 hari | | Ditahan | 4 | 7 hari | | Dibatalkan | 1 | 1 hari | | Dibatalkan | 2 | 3 hari | | Dibatalkan | 3 | 5 hari | | Dibatalkan | 4 | 7 hari | ### Contoh Email Dunning Dunning mengirimkan email yang berbeda tergantung pada status langganan. Di bawah ini adalah contoh masing-masing jenis seperti yang dilihat oleh pelanggan. Email dunning untuk langganan yang ditahan menampilkan nama toko, pesan tentang pembayaran yang gagal, detail langganan dengan paket dan jumlah, serta tombol Metode Pembayaran Perbarui Email dunning untuk langganan yang dibatalkan menampilkan nama toko, pesan tentang pembatalan, detail langganan dengan paket dan jumlah, serta tombol Pembelian Ulang Langganan ## Pengalaman Pemulihan Pelanggan Ketika pelanggan mengklik tautan dalam email dunning, mereka akan diarahkan ke portal pelanggan di mana mereka dapat melihat status langganan mereka dan memperbarui metode pembayaran mereka. Portal pelanggan menunjukkan langganan yang ditahan untuk Pro Plan seharga $95.00/tahun dengan tombol metode pembayaran perbarui dan banner peringatan tentang pembayaran yang gagal Setelah pelanggan memperbarui metode pembayaran mereka, biaya otomatis dibuat untuk kewajiban yang tertunda. Jika pembayaran berhasil, langganan akan diaktifkan kembali segera. Untuk langganan yang dibatalkan, pelanggan akan diarahkan ke halaman pembayaran yang sudah memiliki langganan tersebut ditambahkan sebagai produk. ## Analitik Lacak kinerja Dunning dari tab **Recovery** di bagian **Analytics** dari dashboard Anda. Dasbor analitik pemulihan yang menunjukkan jumlah entri dunning, tingkat keberhasilan, pendapatan yang dipulihkan, dan rincian kinerja per-email | Metrik | Deskripsi | | ----------------------- | --------------------------------------------------------------- | | **Dunning Entries** | Jumlah total percobaan dunning yang dibuat | | **Success Rate** | Persentase percobaan dunning yang berhasil memulihkan langganan | | **Recovered Revenue** | Total pendapatan yang dipulihkan melalui dunning | | **Recovery by Attempt** | Rincian email mana dalam rangkaian yang mendorong pemulihan | ## Peristiwa Webhook | Event | Deskripsi | | ------------------- | ------------------------------------------------------ | | `dunning.started` | Sebuah percobaan dunning telah dimulai untuk langganan | | `dunning.recovered` | Sebuah langganan telah dipulihkan melalui dunning | Lihat skema payload webhook lengkap untuk peristiwa dunning. ## Kasus Tepi | Skenario | Perilaku | | ------------------------------------------------------------- | ----------------------------------------------------------------------------- | | Pelanggan memperbarui metode pembayaran sebelum email dikirim | Pemulihan terdeteksi; percobaan dunning ditandai sebagai pulih | | Pelanggan membeli langganan lain dari bisnis yang sama | Percobaan dunning ditandai sebagai habis | | Semua email dunning habis | Percobaan dunning ditandai sebagai habis; status langganan tidak dimodifikasi | ## Praktik Terbaik * **Mulai dengan pengaturan default**: Waktu pengiriman email default dirancang dengan jarak yang wajar (1, 3, 5, dan 7 hari) untuk menghindari membuat pelanggan kewalahan sambil menjaga urgensi. * **Monitor tingkat keberhasilan**: Lacak email mana dalam rangkaian yang menghasilkan pemulihan terbanyak. Jika email selanjutnya memiliki konversi mendekati nol, pertimbangkan untuk menonaktifkannya. * **Koordinasikan dengan dukungan**: Pastikan tim dukungan Anda tahu bahwa email dunning dikirim, sehingga mereka dapat membantu pelanggan yang menghubungi. * **Tinjau status langganan**: Padukan dunning dengan `subscription.on_hold` dan `subscription.cancelled` webhooks untuk pelacakan siklus hidup yang komprehensif. Dunning bekerja bersama alur pengaktifan kembali langganan yang sudah ada di portal pelanggan. Setelah diaktifkan, ia berjalan secara otomatis tanpa memerlukan integrasi tambahan. ## Terkait Reaksi terhadap peristiwa `dunning.started` dan `dunning.recovered`. Pulihkan checkout satu kali yang tidak lengkap atau gagal dengan email yang ditargetkan. Pelanggan memperbarui metode pembayaran melalui portal pelanggan. Pahami status langganan yang memicu alur kerja dunning.