Skip to main content
Payment Retries secara otomatis mencoba kembali pembayaran perpanjangan langganan yang gagal berdasarkan jadwal back-off progresif. Saat percobaan ulang berhasil, langganan diaktifkan kembali secara otomatis — tanpa tindakan pelanggan atau pekerjaan integrasi.

Apa Itu Payment Retries?

Saat pembayaran perpanjangan langganan gagal, langganan ditempatkan dalam status on hold. Dengan Payment Retries yang diaktifkan, Dodo Payments secara otomatis menagih kembali metode pembayaran pelanggan yang sudah ada berdasarkan jadwal cerdas hingga pembayaran berhasil atau periode pemulihan berakhir. Ini memulihkan pendapatan yang hilang akibat kegagalan sementara — penangguhan kartu yang kedaluwarsa, dana tidak mencukupi yang kemudian ditambahkan, kesalahan jaringan sementara — tanpa mengirim email kepada pelanggan atau meminta mereka memperbarui apa pun.
Payment Retries hanya berlaku untuk pembayaran perpanjangan langganan. Pembayaran pertama (penyiapan mandat), pembayaran satu kali, biaya perubahan paket, dan biaya on-demand tidak dicoba kembali oleh fitur ini.

Cara Kerja Payment Retries

1

Renewal fails

Pembayaran perpanjangan langganan gagal dan langganan berpindah ke status on_hold.
2

Retryability check

Kode error kegagalan diperiksa. Soft decline (dana tidak mencukupi, penolakan umum, error pemrosesan atau jaringan, dan sebagainya) dapat dicoba kembali. Hard decline langsung mengakhiri rangkaian percobaan ulang, karena percobaan ulang tidak akan mengubah hasilnya.
3

Scheduled retry

Jika penolakan dapat dicoba kembali dan periode pemulihan masih memungkinkannya, percobaan berikutnya dijadwalkan. Percobaan ulang dijalankan off-session menggunakan metode pembayaran pelanggan yang sudah ada berdasarkan jadwal back-off progresif.
4

Recovery

Pada percobaan ulang pertama yang berhasil, langganan kembali ke active dan tanggal penagihan berikutnya dimajukan seperti biasa. Jika periode tersebut berakhir sebelum percobaan ulang berhasil, percobaan ulang dihentikan dan langganan tetap dalam status on hold.

Mengonfigurasi Payment Retries

Aktifkan dan konfigurasikan Payment Retries dari Settings → Recovery di dashboard Anda.
Halaman Recovery Settings dengan toggle Enable Payment Retries aktif dan kolom Recovery window (days) diatur ke 13

Payment Retries settings under Settings → Recovery

Periode pemulihan dihitung sejak waktu invoice perpanjangan yang gagal dibuat. Percobaan ulang hanya dijadwalkan selama total penundaan back-off masih berada dalam periode tersebut.

Jadwal Percobaan Ulang

Penundaan percobaan ulang meningkat secara progresif. Hingga 8 percobaan dilakukan, selama masing-masing masih berada dalam periode pemulihan Anda:
Periode pemulihan selama 13 hari (default) mencakup percobaan 1 hingga 5 (percobaan 5 dijalankan sekitar 10,5 hari setelah kegagalan). Tingkatkan periode tersebut hingga maksimum 30 hari jika Anda ingin percobaan berikutnya yang berjarak lebih panjang (6 hingga 8) dijalankan.

Transisi Status Langganan

Jika langganan dibatalkan saat percobaan ulang masih dijadwalkan, rangkaian percobaan ulang langsung berakhir dan tidak ada percobaan berikutnya. Status nonaktif lainnya (on_hold, expired, pending, failed) tetap menjalani percobaan ulang, karena invoice perpanjangan yang terbuka mewakili utang untuk periode yang telah digunakan pelanggan.
Transisi ini memicu event webhook langganan standar, sehingga Anda dapat menggunakannya untuk menjalankan logika hak akses tanpa penanganan percobaan ulang khusus:

Subscription Webhook Payloads

Lihat skema payload webhook lengkap untuk event siklus hidup langganan.

Kegagalan yang Dapat dan Tidak Dapat Dicoba Kembali

Mencoba kembali hard decline tidak akan mengubah hasilnya, sehingga rangkaian percobaan ulang berakhir segera setelah hard decline terdeteksi. Gunakan Payment Retries bersama Subscription Dunning untuk meminta pelanggan memperbarui metode pembayaran mereka dalam kasus tersebut.

Payment Retries vs. Dunning

Payment Retries dan Subscription Dunning adalah alat pemulihan yang saling melengkapi: Mengaktifkan keduanya memberikan cakupan pemulihan terluas: percobaan ulang otomatis menangani kegagalan sementara, sementara dunning mengembalikan pelanggan yang metode pembayarannya memang perlu diperbarui.

Terkait

Subscription Dunning

Urutan email yang meminta pelanggan memperbarui metode pembayaran mereka.

Abandoned Cart Recovery

Pulihkan checkout satu kali yang belum selesai atau gagal dengan email yang ditargetkan.

Subscriptions

Pahami status langganan yang terlibat dalam alur pemulihan.

Subscription Webhooks

Tanggapi event subscription.on_hold dan subscription.active.
Terakhir diubah pada 21 Juli 2026