Recurring Payment Gateway adalah solusi pembayaran yang memungkinkan bisnis menagih pelanggan secara otomatis dan berulang sesuai jadwal yang telah ditentukan, misalnya setiap bulan atau setiap tahun untuk layanan berlangganan.
DOKU mendukung kebutuhan pembayaran berulang melalui DOKU Checkout maupun DOKU Direct API, termasuk dukungan tokenisasi untuk mempermudah transaksi berikutnya. Simak penjelasan detailnya berikut ini!
Apa itu Recurring Payment?
Recurring Payment Gateway adalah mekanisme pembayaran berulang yang dilakukan secara berkala berdasarkan jadwal atau siklus tertentu.
Contohnya, pelanggan berlangganan layanan SaaS dengan biaya Rp100.000 per bulan. Setelah pembayaran dan persetujuan awal dilakukan, transaksi berikutnya dapat diproses kembali sesuai periode yang telah ditentukan.
Berbeda dengan pembayaran satu kali, Recurring Payment Gateway dirancang untuk kebutuhan transaksi yang terus berulang, seperti langganan bulanan, membership tahunan, biaya kursus, premi, atau layanan digital.
Dalam ekosistem payment gateway, Recurring Payment Gateway membantu bisnis mengurangi proses penagihan manual sekaligus menciptakan pengalaman pembayaran yang lebih praktis bagi pelanggan.
Recurring vs Subscription vs One-Time Payment
Istilah recurring, subscription, dan one time payment sering digunakan secara bergantian. Ketiga ini memiliki konteks yang berbeda. Berikut penjelasannya.

Baca juga: Mengenal Fitur-Fitur DOKU Checkout
Bagaimana Cara Kerja Recurring Payment?
Secara umum, alur Recurring Payment Gateway dimulai ketika pelanggan memilih paket berlangganan dan melakukan pembayaran pertama. Setelah pelanggan memberikan persetujuan untuk pembayaran berikutnya, kredensial pembayaran dapat disimpan dalam bentuk token.
Pada periode berikutnya, sistem bisnis dapat menggunakan token tersebut untuk memproses pembayaran tanpa meminta pelanggan memasukkan kembali detail kartu. Alurnya dapat digambarkan sebagai berikut:
- Pelanggan memilih paket subscription.
- Pelanggan melakukan pembayaran pertama.
- Pelanggan memberikan consent untuk transaksi berikutnya.
- Data pembayaran diproses dan dapat ditokenisasi.
- Bisnis menentukan jadwal dan nominal recurring.
- Pada tanggal jatuh tempo, sistem mengirim permintaan pembayaran.
- Payment gateway memproses transaksi.
- Bisnis menerima status transaksi.
- Sistem memperbarui status subscription berdasarkan hasil pembayaran.
Untuk mempermudah proses ini, DOKU menyediakan fitur recurring untuk membantu penagihan otomatis pada kebutuhan pembayaran berkala, seperti langganan atau cicilan.
Implementasi Recurring Payment di DOKU Checkout Page (Hosted)
Untuk bisnis yang ingin menerapkan recurring payment tanpa membangun halaman pembayaran sendiri, DOKU Checkout dapat digunakan sebagai Hosted Checkout. Berikut langkah-langkahnya.
1. Daftar dan Aktifkan Akun Merchant DOKU
- Daftarkan bisnis sebagai merchant DOKU.
- Setelah akun aktif, akses DOKU Back Office untuk mendapatkan kredensial yang dibutuhkan.
2. Integrasikan DOKU Checkout ke Website atau Aplikasi
- Siapkan integrasi dari sisi backend untuk melakukan inisiasi pembayaran.
- Backend akan mengirimkan request ke DOKU untuk mendapatkan payment url.
- Tampilkan halaman DOKU Checkout melalui metode redirect atau pop-up atau embedded checkout, sesuai kebutuhan pengalaman pengguna.
3. Aktifkan Fitur Tokenisasi atau Save Card
- Pada pembayaran pertama, pelanggan melakukan transaksi menggunakan kartu yang dipilih.
- Berikan opsi kepada pelanggan untuk menyimpan kartu sesuai consent yang diberikan.
- DOKU akan menangani data kartu dan menyediakan token yang dapat digunakan untuk transaksi berikutnya.
- Merchant tidak perlu menyimpan detail kartu pelanggan secara langsung.
4. Hubungkan Token dengan Data Subscription
- Simpan token pada sistem merchant dan hubungkan dengan data pelanggan atau subscription.
- Catat informasi seperti ID pelanggan, paket langganan, nominal, periode billing, dan tanggal pembayaran berikutnya.
- Token kemudian dapat digunakan sebagai referensi untuk proses pembayaran berikutnya sesuai skema recurring yang diterapkan.
5. Atur Siklus dan Jadwal Penagihan
- Tentukan periode pembayaran, misalnya mingguan, bulanan, atau tahunan.
- Tentukan nominal yang akan ditagihkan pada setiap periode.
- Sistem bisnis kemudian dapat menjalankan proses billing sesuai jadwal subscription.
- DOKU menyediakan fitur recurring untuk mendukung penagihan pembayaran secara berulang, termasuk kebutuhan seperti langganan atau cicilan.
6. Proses Pembayaran Berulang
- Ketika periode subscription berikutnya tiba, sistem menjalankan proses penagihan menggunakan informasi pembayaran yang telah ditokenisasi.
- Pelanggan tidak perlu memasukkan kembali seluruh detail kartu untuk setiap periode, selama mekanisme transaksi dan consent yang digunakan memungkinkan hal tersebut.
- Status pembayaran kemudian digunakan untuk memperbarui status subscription pelanggan.
7. Siapkan Handling untuk Pembayaran Gagal
- Tentukan tindakan ketika transaksi recurring gagal.
- Sistem dapat menandai tagihan sebagai gagal dan menjalankan mekanisme retry sesuai aturan bisnis.
- Kirimkan notifikasi kepada pelanggan apabila diperlukan, misalnya untuk meminta pelanggan memperbarui metode pembayaran.
- Pastikan status subscription ikut diperbarui berdasarkan hasil pembayaran.
8. Uji Seluruh Flow di Sandbox

Sebelum masuk ke tahap production, lakukan pengujian terhadap seluruh alur, mulai dari pembayaran pertama, penyimpanan kartu, recurring payment, hingga skenario transaksi gagal. DOKU Sandbox memang disediakan untuk membantu merchant mengembangkan dan menguji alur pembayaran tanpa menggunakan transaksi nyata.
9. Aktifkan di Production
Setelah proses pengujian selesai dan seluruh integrasi berjalan dengan baik, merchant dapat mengaktifkan payment flow di tahap production.
Implementasi Recurring Payment di DOKU Direct API (Self-Hosted)
Berbeda dengan DOKU Checkout Page (Hosted), implementasi Recurring Payment Gateway melalui DOKU Direct API memberikan merchant kontrol lebih besar terhadap tampilan dan alur pembayaran di website atau aplikasi.
1. Daftar dan Siapkan Akun Merchant DOKU
- Daftarkan bisnis sebagai merchant DOKU dan lengkapi proses verifikasi.
- Siapkan credential API yang diperlukan untuk proses integrasi.
- Pastikan fitur dan metode pembayaran yang dibutuhkan untuk recurring tersedia pada akun merchant.
- Gunakan environment Sandbox terlebih dahulu untuk melakukan pengujian integrasi.
2. Bangun Payment Flow di Website atau Aplikasi
- Buat halaman pembayaran langsung di website atau aplikasi milik merchant.
- Atur alur pelanggan mulai dari memilih paket subscription hingga melakukan pembayaran.
- Sediakan informasi yang jelas mengenai nominal, periode penagihan, dan persetujuan pembayaran berulang.
- Pastikan payment flow tetap mengikuti ketentuan keamanan dan integrasi yang ditetapkan DOKU
3. Inisiasi Pembayaran Pertama melalui Direct API
- Backend merchant mengirimkan request pembayaran pertama ke DOKU melalui API.
- Pelanggan menyelesaikan transaksi sesuai payment flow yang telah dibuat.
- Gunakan transaksi pertama sebagai bagian dari proses aktivasi subscription.
- Pastikan sistem mencatat ID atau informasi transaksi yang dibutuhkan untuk proses selanjutnya.
4. Implementasikan Tokenisasi atau Saved Credential
- Aktifkan mekanisme tokenisasi sesuai fitur dan metode pembayaran yang digunakan.
- Setelah pelanggan memberikan consent, data pembayaran dapat direpresentasikan dalam bentuk token.
- Hindari menyimpan detail kartu pelanggan secara langsung di database merchant.
- Hubungkan token dengan data pelanggan atau subscription di sistem internal.
5. Simpan dan Kelola Data Subscription
- Buat sistem untuk menyimpan informasi subscription pelanggan.
- Data dapat mencakup customer ID, paket, nominal, periode billing, tanggal penagihan berikutnya, dan status subscription.
- Hubungkan data subscription dengan token pembayaran yang digunakan.
- Gunakan data tersebut sebagai acuan ketika sistem menjalankan penagihan berikutnya.
6. Buat Scheduler untuk Pembayaran Berulang
- Tentukan jadwal recurring berdasarkan periode subscription, seperti mingguan, bulanan, atau tahunan.
- Buat scheduler atau billing engine yang mendeteksi subscription yang sudah memasuki tanggal penagihan.
- Scheduler kemudian memicu proses pembayaran melalui backend merchant.
- Pastikan sistem dapat menangani perbedaan tanggal jatuh tempo dan status subscription setiap pelanggan.
7. Kirim Request Recurring ke DOKU
- Backend merchant mengirimkan request pembayaran ke DOKU ketika jadwal billing tiba.
- Gunakan token atau credential pembayaran yang telah disiapkan untuk transaksi berikutnya.
- Pastikan request mengikuti endpoint, parameter, autentikasi, dan mekanisme recurring sesuai dokumentasi DOKU.
- Gunakan response dari DOKU untuk menentukan hasil transaksi.
8. Kelola Callback dan Status Transaksi
- Siapkan endpoint untuk menerima notifikasi atau callback transaksi dari DOKU.
- Perbarui status invoice atau pembayaran berdasarkan hasil transaksi.
- Jika pembayaran berhasil, sistem dapat mempertahankan subscription sebagai active.
- Jika pembayaran gagal, sistem dapat menandai transaksi sebagai failed atau past due sesuai business logic.
9. Siapkan Retry dan Payment Recovery
- Tentukan aturan retry ketika recurring payment gagal.
- Sistem dapat mencoba kembali transaksi sesuai jadwal yang telah ditentukan.
- Kirim notifikasi kepada pelanggan apabila diperlukan, misalnya untuk memperbarui metode pembayaran.
- Hubungkan hasil recovery dengan status subscription agar akses layanan dapat dikelola secara otomatis.
10. Uji Seluruh Flow di Sandbox
- Uji proses pembayaran pertama hingga tokenisasi berhasil.
- Simulasikan proses recurring sesuai jadwal yang ditentukan.
- Uji skenario pembayaran berhasil, gagal, callback, retry, dan perubahan status subscription.
- Pastikan seluruh data transaksi dapat tercatat dengan benar di sistem internal.
11. Pindahkan Integrasi ke Production
- Setelah seluruh skenario berhasil diuji, pindahkan integrasi dari Sandbox ke tahap production.
- Gunakan credential dan konfigurasi production yang sesuai.
- Pastikan webhook, scheduler, database subscription, serta error handling sudah siap.
- Pantau transaksi recurring setelah implementasi untuk memastikan proses billing berjalan sesuai kebutuhan.
Dengan DOKU Direct API, merchant memiliki fleksibilitas lebih besar untuk membangun recurring payment yang terintegrasi dengan sistem billing sendiri.
Baca juga: Model Bisnis Subscription: Cara Cerdas Bikin Pelanggan Balik Lagi
Komponen Jadwal, Amount, Retry, dan Status Pembayaran pada Recurring Payment
Sistem recurring perlu memiliki aturan yang jelas untuk setiap siklus billing. Beberapa komponen penting yang perlu diperhatikan meliputi:
- Jadwal: menentukan kapan tagihan berikutnya diproses, misalnya setiap tanggal 1 setiap bulan.
- Amount: menentukan nominal yang ditagihkan pada setiap periode.
- Retry: menentukan tindakan ketika pembayaran pertama gagal, misalnya mencoba kembali pada waktu tertentu.
- Payment Status: mencatat apakah transaksi berhasil, gagal, pending, atau membutuhkan tindakan lebih lanjut.
- Subscription Status: memperbarui status pelanggan, misalnya active, past due, atau cancelled.
Dengan struktur tersebut, bisnis dapat menghubungkan status pembayaran dengan akses layanan.
Use Case Recurring Payment untuk SaaS, Subscription, Membership, dan Billing Berkala
Recurring payment dapat diterapkan pada berbagai bisnis yang membutuhkan penagihan secara otomatis dan berulang sesuai periode layanan.
1. SaaS atau Software as a Service
Bisnis SaaS dapat menggunakan recurring payment untuk menagihkan biaya penggunaan software secara bulanan atau tahunan. Pembayaran berikutnya dapat diproses sesuai siklus subscription tanpa pelanggan harus melakukan pembayaran manual.
2. Subscription Layanan Digital
Layanan seperti streaming, aplikasi premium, dan platform konten dapat menggunakan recurring payment untuk memperpanjang akses secara otomatis. Metode pembayaran yang tersimpan dapat digunakan untuk transaksi berikutnya sesuai consent dan mekanisme pembayaran yang berlaku.
3. Membership
Bisnis seperti gym atau platform membership dapat menerapkan recurring payment untuk biaya keanggotaan berkala. Sistem dapat memperbarui status membership berdasarkan keberhasilan pembayaran setiap periode.
4. Billing Berkala
Recurring payment juga dapat digunakan untuk layanan yang memiliki tagihan rutin, seperti maintenance, layanan profesional, atau biaya penggunaan platform. Bisnis dapat menentukan jadwal dan nominal tagihan sesuai kesepakatan dengan pelanggan.
5. Integrasi dengan Sistem Billing
Recurring payment dapat dihubungkan dengan sistem billing internal untuk mengelola jadwal, nominal, dan status pembayaran pelanggan. Dengan integrasi ini, proses penagihan dapat berjalan lebih terstruktur agar mudah melakukan monitoring dan reconciliation.
Payment Failure & Recovery dalam Sistem Recurring Payment
Tidak semua recurring payment akan berhasil. Kegagalan dapat terjadi karena kartu kedaluwarsa, limit tidak mencukupi, transaksi ditolak, atau masalah lainnya.
Karena itu, sistem recurring sebaiknya memiliki mekanisme payment recovery. Misalnya, sistem dapat melakukan retry berdasarkan aturan yang telah ditentukan, mengirimkan notifikasi kepada pelanggan, atau menyediakan opsi untuk memperbarui metode pembayaran.
Tujuannya bukan hanya meningkatkan kemungkinan pembayaran berhasil, tetapi juga mencegah pelanggan kehilangan akses layanan secara tiba-tiba.
Pentingnya Security, Consent, dan Customer Communication
Recurring payment membutuhkan perhatian lebih terhadap keamanan dan persetujuan pelanggan. Sebelum pembayaran berulang dilakukan, pelanggan perlu memahami bahwa metode pembayaran yang digunakan akan diproses kembali sesuai ketentuan subscription.
Bisnis juga perlu memberikan informasi yang jelas mengenai nominal, periode penagihan, cara membatalkan subscription, serta komunikasi ketika pembayaran berhasil atau gagal.
Permudah Pembayaran Berulang, Terima Pembayaran, dan Kelola Transaksi Langganan Bersama DOKU

Bisnis berbasis langganan membutuhkan proses penagihan yang konsisten agar pelanggan dapat menikmati layanan tanpa harus melakukan pembayaran manual setiap periode. DOKU Payment Gateway membantu merchant menjalankan pembayaran berulang sekaligus menerima dan mengelola transaksi bisnis secara lebih praktis.
Bagi bisnis yang membutuhkan halaman pembayaran siap pakai, DOKU Checkout menyediakan payment gateway checkout dengan fitur Recurring Payment melalui metode kartu yang didukung. Sementara itu, DOKU Direct API merupakan solusi self hosted payment gateway yang memungkinkan merchant mengembangkan halaman pembayaran sendiri dan mengintegrasikan alur pembayaran berulang sesuai kebutuhan sistem bisnis.
Untuk menerima pembayaran, layanan payment gateway DOKU mendukung 45+ metode pembayaran, termasuk Virtual Account, kartu, e-wallet, QRIS, PayLater, Direct Debit, dan berbagai metode pembayaran lainnya.
DOKU juga menyediakan beragam fitur pembayaran, seperti Tokenisasi dan berbagai fitur lainnya. Tersedia pula Power Up seperti Customer Static VA, Visa Network Token, QRIS Cross-Border, hingga MCP Server untuk Agentic Payments.
Melalui DOKU Dashboard, bisnis dapat memantau transaksi, settlement, refund, dan rekonsiliasi, dilengkapi Payment Analytics serta Multi-Brand & Team Access.
DOKU, Lebih dari Sekadar Payment Gateway
Sebagai pionir payment gateway sejak 2007, DOKU telah berkembang menjadi payment fintech company yang mendukung lebih dari 300.000 merchant di berbagai industri dan skala bisnis.
Ekosistemnya juga mencakup DOKU Wallet as a Service melalui Embedded Wallet dan Sub Account, serta DOKU Payout melalui Local Payout dan Cross Border Payout.
DOKU menyediakan pendampingan after-sales proaktif dan customer service 24/7, serta beroperasi sebagai PJP Kategori 1 dengan kredensial keamanan PCI DSS dan ISO/IEC 27001.
Permudah penagihan langganan, terima berbagai metode pembayaran, dan kelola transaksi bisnis melalui DOKU Registration atau hubungi tim Sales DOKU untuk menemukan solusi pembayaran yang sesuai dengan kebutuhan bisnis Anda.
