Portal Pelanggan - Dodo Payments Documentation

Customer Portal adalah area aman yang dihosting di mana pelanggan Anda dapat mengelola langganan, melihat faktur, dan mengakses detail kunci lisensi—tanpa menghubungi dukungan.

Create Portal Session (API)

Buat sesi portal yang aman dan terbatas waktu secara programatis.

Subscriptions

Kelola rencana berulang, peningkatan, penurunan, dan tambahan.

Portal Pelanggan yang diperbarui menunjukkan langganan aktif, metode pembayaran, dan riwayat penagihan

Apa Itu Portal Pelanggan?

Portal ini menyediakan pengalaman layanan mandiri yang terpercaya dan bermerek bagi pelanggan untuk:

Akses riwayat penagihan: Lihat invoice dan unduh tanda terima.
Kelola langganan: Lihat detail langganan, jeda dan lanjutkan langganan, serta batalkan langganan segera atau pada tanggal penagihan berikutnya.
Perbarui metode pembayaran: Ubah metode pembayaran untuk langganan aktif atau aktifkan kembali langganan yang ditangguhkan.
Ambil kunci lisensi: Akses semua kunci yang terkait dengan pembelian.
Navigasi dengan mudah: Gunakan tombol kembali untuk berpindah antarbagian portal tanpa kehilangan konteks.

Manfaat Utama

Volume dukungan lebih rendah: Pelanggan menyelesaikan permintaan penagihan umum sendiri
Waktu untuk nilai lebih cepat: Akses langsung ke faktur dan kunci
Risiko churn berkurang: Visibilitas jelas ke pembaruan dan detail rencana
Aman secara desain: Akses token dengan tautan kedaluwarsa
Pengalaman terlokalisasi: Portal tersedia dalam 21 bahasa, dengan deteksi otomatis berdasarkan preferensi browser pelanggan

Metode Akses

Pelanggan dapat mengakses portal menggunakan tautan statis atau tautan dinamis satu kali.

Tautan Statis (akses berbasis email)

Pelanggan dapat meminta akses portal dengan memasukkan email mereka di tautan statis yang tidak pernah kedaluwarsa. Format tautan portal statis bervariasi berdasarkan lingkungan: Mode Uji (untuk pengujian dan pengembangan):

https://test.customer.dodopayments.com/login/{business_id}

Mode Langsung (untuk produksi dengan transaksi nyata):

https://customer.dodopayments.com/login/{business_id}

Ganti {business_id} dengan pengenal bisnis Anda yang sebenarnya, lalu bagikan tautan yang sesuai kepada pelanggan agar mereka dapat memasukkan email mereka dan menerima akses aman ke portal.

Merchant flow

Buka Sales → Customer.
Klik Share invite.
Salin Static link dan bagikan ke pelanggan Anda.

Customer flow

Buka tautan statis.
Masukkan email yang digunakan saat pembelian.
Terima tautan masuk aman untuk mengakses portal.

Pelanggan yang sudah ada dikenali secara otomatis.

Tautan Dinamis (tautan ajaib)

Tautan ajaib yang dipersonalisasi dan satu kali yang mengirim pelanggan langsung ke portal. Tautan ini kedaluwarsa dalam 24 jam.

Tautan dinamis kedaluwarsa setelah 24 jam. Jika kedaluwarsa, buat dan kirim tautan baru.

Merchant flow

Buka Sales → Customer.
Klik Share invite.
Salin Dynamic link dan bagikan ke pelanggan Anda.

Customer flow

Buka tautan dinamis.
Akses Customer Portal langsung tanpa memasukkan email.

Fitur Portal

Customer Portal yang diperbarui menyediakan antarmuka bersih, terpadu dengan bilah sisi kiri dan bagian terorganisir untuk semua kebutuhan manajemen akun.

Active Subscriptions

Lihat semua langganan aktif beserta nama paket, harga, tanggal perpanjangan, dan masa berlaku. Klik “Manage subscription” untuk melihat detail, mengedit informasi penagihan, menjeda, atau membatalkan.

Payment Methods

Lihat semua metode pembayaran yang tersimpan (kartu, UPI, dll.) secara sekilas. Edit metode pembayaran langsung dari detail langganan.

Billing History

Lihat semua transaksi dalam tabel rinci dengan tanggal, status, jenis harga, hak akses, dan faktur yang dapat diunduh.

Billing Information

Lihat dan edit nama, email, nomor telepon, dan alamat penagihan dari halaman detail langganan.

Ikhtisar Portal

Halaman utama portal menampilkan semua langganan aktif, metode pembayaran yang tersimpan, dan riwayat penagihan dalam satu tampilan yang dapat digulir.

Halaman utama Portal Pelanggan menunjukkan langganan aktif dan metode pembayaran

Metode Pembayaran & Riwayat Penagihan

Gulir ke bawah untuk melihat metode pembayaran yang tersimpan dan riwayat penagihan lengkap dengan indikator status serta faktur yang dapat diunduh.

Metode pembayaran dan riwayat penagihan dengan unduhan faktur

Dukungan Bahasa

Portal Pelanggan tersedia dalam 21 bahasa, sehingga pelanggan Anda dapat mengelola langganan, metode pembayaran, dan riwayat penagihan dalam bahasa yang mereka nyaman gunakan.

Cara pemilihan bahasa bekerja

Deteksi otomatis: Pada kunjungan pertama, portal mendeteksi bahasa pilihan pelanggan dari pengaturan browser mereka dan memuat terjemahan yang sesuai jika tersedia. Bahasa Inggris digunakan sebagai cadangan.
Penggantian manual: Pelanggan dapat mengubah bahasa aktif kapan saja dari pemilih bahasa di header portal (tersedia di desktop dan mobile).
Preferensi yang dipertahankan: Bahasa yang dipilih disimpan dalam cookie NEXT_LOCALE (valid selama 1 tahun) sehingga portal mengingat pilihan tersebut di antara sesi-sesi.

Bahasa yang Didukung

Bahasa	Kode	Bahasa	Kode
Inggris (default)	`en`	Indonesia	`id`
Arab	`ar`	Italia	`it`
Katalan	`ca`	Jepang	`ja`
Cina	`zh`	Korea	`ko`
Belanda	`nl`	Melayu	`ms`
Prancis	`fr`	Polandia	`pl`
Jerman	`de`	Portugis	`pt`
Ibrani	`he`	Rumania	`ro`
Rusia	`ru`	Spanyol	`es`
Swedia	`sv`	Thailand	`th`
Turki	`tr`

Perubahan Paket (Upgrade/Downgrade)

Ketika produk diatur ke dalam Koleksi Produk, pelanggan dapat melakukan upgrade atau downgrade antara paket secara langsung dari Portal Pelanggan.

Ingin mengaktifkan upgrade/downgrade untuk langganan yang ada? Tambahkan produk langganan Anda ke Koleksi Produk. Setelah dikelompokkan, pelanggan dapat beralih antara paket dalam koleksi yang sama melalui Portal Pelanggan.

Aksi yang Tersedia

Aksi	Deskripsi	Kapan Tersedia
Upgrade	Pindah ke paket tingkatan lebih tinggi dalam koleksi yang sama	Bisnis telah mengaktifkan pembaruan langganan
Downgrade	Pindah ke paket tingkatan lebih rendah dalam koleksi yang sama	Bisnis telah mengaktifkan pembaruan langganan

Cara Kerja Perubahan Paket

Customer mengeklik Change Plan pada halaman detail subscription.
Opsi upgrade/downgrade yang tersedia ditampilkan berdasarkan product collection.
Customer memilih plan baru. Panel Confirm Plan Change menampilkan plan saat ini dibandingkan dengan plan yang diperbarui, rincian line item (kredit untuk plan lama, biaya untuk plan baru), pajak, dan jumlah yang harus dibayar sekarang. Customer juga dapat menambahkan discount code di sini.
Customer mengonfirmasi dengan Pay ${amount}.
Proration dihitung dan biaya diproses — baik melalui payment method yang tersimpan maupun melalui hosted checkout page jika bisnis menagih pembayaran perubahan plan melalui payment link (lihat di bawah).
Subscription diperbarui ke plan baru. Apakah perubahan tersebut terjadi segera atau hanya setelah biaya berhasil dibayar bergantung pada payment failure handling; perubahan plan yang dibayar melalui payment link selalu menunggu pembayaran.

Halaman detail subscription dengan tombol Change Plan, Pause Subscription, dan Cancel Subscription

Panel Confirm Plan Change yang menampilkan plan saat ini dibandingkan dengan plan yang diperbarui, rincian line item, input discount code, dan tombol Pay

Perubahan plan hanya tersedia di antara produk dalam collection yang sama. Produk harus menggunakan jenis billing subscription atau usage-based.

Mengumpulkan Pembayaran Perubahan Plan melalui Payment Link

Secara default, perubahan plan segera membebankan payment method tersimpan milik customer secara langsung. Dengan mengaktifkan Collect Plan Change Payments by Payment Link, perilakunya berubah: alih-alih membebankan kartu yang tersimpan, customer diarahkan ke halaman Dodo Checkout untuk membayar. Hal ini berlaku untuk upgrade maupun downgrade yang menghasilkan biaya.

Halaman Settings → Subscriptions dengan toggle Collect Plan Change Payments by Payment Link yang diaktifkan dan tooltip yang menjelaskan perilakunya

Halaman hosted Dodo Checkout dari contoh terpisah, tempat customer membayar perubahan plan

Subscription tetap menggunakan current plan hingga pembayaran checkout tersebut berhasil — pembayaran yang gagal atau ditinggalkan tidak mengubah subscription, sehingga customer dapat mencoba lagi dalam checkout session yang sama. Downgrade terjadwal (effective_at: next_billing_date) tidak terpengaruh dan tetap diterapkan pada tanggal billing berikutnya tanpa melalui checkout.

Hal ini hanya berlaku untuk perubahan plan immediate. Jika customer sudah memiliki payment link perubahan plan yang tertunda, permintaan perubahan plan berikutnya akan ditolak hingga link tersebut dibayar atau kedaluwarsa.

Plan Change via Payment Link (API)

Cara meminta payment link dengan collect_via_payment_link dan menangani responsnya.

Kontrol Bisnis

Bisnis dapat mengonfigurasi perilaku subscription portal di Subscription Settings:

Allow Subscription Updates: Mengaktifkan atau menonaktifkan kemampuan customer untuk melakukan upgrade atau downgrade subscription mereka
Allow Subscription Cancellation: Mengaktifkan atau menonaktifkan kemampuan customer untuk membatalkan subscription mereka sendiri
Allow Subscription Pause: Mengaktifkan atau menonaktifkan kemampuan customer untuk menjeda dan melanjutkan subscription mereka sendiri
Collect Plan Change Payments by Payment Link: Mengarahkan customer ke halaman checkout untuk membayar perubahan plan yang segera diterapkan, alih-alih membebankan payment method yang tersimpan. Dinonaktifkan secara default.

Product Collections

Pelajari cara menyiapkan product collection dan mengonfigurasi jalur upgrade/downgrade.

Detail Subscription

Saat customer mengeklik “Manage subscription” pada subscription aktif mana pun, mereka diarahkan ke halaman detail subscription. Halaman ini menampilkan:

Detail plan: Nama subscription, harga, tanggal renewal, dan masa berlaku
Payment method: Kartu atau payment method yang ditautkan ke subscription, dengan tombol “Edit”
Informasi billing: Nama, email, nomor telepon, dan alamat billing dengan tombol “Edit”
Riwayat billing: Tabel terperinci semua pembayaran untuk subscription ini
Pause: Opsi untuk menjeda subscription, yang ditampilkan jika Anda mengizinkan pause mandiri
Cancel Subscription: Tombol utama untuk membatalkan subscription

Membatalkan Subscription

Customer dapat membatalkan subscription langsung dari halaman detail subscription. Mengeklik “Cancel Subscription” akan membuka dialog konfirmasi dengan dua opsi:

Cancel at next billing date: Subscription tetap aktif hingga periode billing saat ini berakhir, lalu dibatalkan secara otomatis.
Cancel now: Subscription langsung dibatalkan.

Pembatalan mandiri dikontrol oleh pengaturan Allow Subscription Cancellation di Settings → Subscriptions, yang diaktifkan secara default. Saat Anda menonaktifkannya, tombol Cancel Subscription dinonaktifkan dengan tooltip yang meminta customer menghubungi Anda, dan kedua jalur pembatalan di portal — cancel now dan cancel at next billing date — ditolak. Customer yang sudah memiliki pembatalan terjadwal tetap memiliki opsi untuk mencabutnya, sehingga mereka dapat memilih untuk tetap berlangganan. Pembatalan yang Anda lakukan sendiri tidak pernah terpengaruh.

Dialog pembatalan subscription dengan opsi membatalkan pada tanggal billing berikutnya atau segera membatalkan

Alasan Pembatalan

Sebelum mengonfirmasi pembatalan, customer ditanya “Why are you cancelling?” dan diminta memilih alasan dari daftar yang telah disiapkan. Alasan tersebut disimpan pada subscription dan ditampilkan dalam webhook payload serta API, sehingga Anda dapat menganalisis penyebab churn dan menyesuaikan alur win-back.

Modal pembatalan dengan dropdown 'Why are you cancelling?' yang menampilkan alasan seperti Too expensive, Missing features, dan Other

Value	Label yang ditampilkan kepada customer
`too_expensive`	Too expensive
`missing_features`	Missing features
`switched_service`	Switched to another service
`unused`	Not using it enough
`customer_service`	Poor customer service
`low_quality`	Low quality
`too_complex`	Too complex
`other`	Other

Value yang dipilih ditulis ke field cancellation_feedback pada subscription. cancellation_comment teks bebas opsional juga dapat dikumpulkan.

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

Kedua field tersebut juga disertakan dalam webhook payload subscription.cancelled, dan Anda dapat mengisinya secara terprogram melalui PATCH /subscriptions/{subscription_id} saat menjadwalkan atau menjalankan pembatalan melalui API.

Gabungkan cancellation_feedback dengan Subscription Dunning untuk menyesuaikan email win-back — misalnya, kirim discount code kepada pembatal dengan too_expensive dan survei “what’s missing?” kepada pembatal dengan missing_features.

Menjeda Subscription

Pause memberi customer opsi tengah antara mempertahankan subscription dan langsung membatalkannya. Subscription yang dijeda menghentikan billing, tetapi tetap mempertahankan plan dan riwayatnya, sehingga customer dapat kembali menggunakannya nanti tanpa harus memulai dari awal. Customer membuka dialog pause dari halaman detail subscription. Dialog tersebut menyatakan plan saat ini, memperingatkan bahwa akses berakhir segera, dan menjelaskan bagaimana tanggal billing bergeser. Customer mengonfirmasi dengan Pause subscription.

Informasi yang disampaikan kepada customer dan apa yang sebenarnya terjadi:

Akses berhenti segera. Fitur, download, dan license key yang disertakan dalam subscription berhenti berfungsi hingga subscription dilanjutkan.
Pause tidak memiliki tanggal berakhir. Subscription tetap dijeda hingga customer melanjutkannya.
Tidak ada waktu yang hilang. Tanggal billing berikutnya dan tanggal renewal sama-sama bergeser maju sesuai lamanya pause.

Melanjutkan subscription mengikuti alur yang sama. Subscription kembali ke status active dan aksesnya dipulihkan.

Pause mandiri dikontrol oleh pengaturan Allow Subscription Pause di Settings → Subscriptions, dan dinonaktifkan secara default. Saat pengaturan ini nonaktif, customer tidak dapat memulai pause baru, meskipun customer yang sudah dalam status paused tetap dapat melanjutkan pause yang mereka mulai sendiri. Pause yang Anda lakukan sendiri dari dashboard tidak pernah terpengaruh.

How Pausing Works

Perilaku pause secara lengkap, termasuk dampak billing, penyelesaian penggunaan, dan webhook.

Memperbarui Payment Method

Customer dapat memperbarui payment method langsung dari halaman detail subscription dengan mengeklik “Edit” di sebelah payment method. Fitur ini sangat penting khususnya untuk mengaktifkan kembali subscription yang ditangguhkan akibat pembayaran gagal.

Mengaktifkan Kembali Subscription yang Ditangguhkan

Saat subscription ditempatkan dalam status on_hold akibat pembayaran gagal, customer harus memperbarui payment method untuk mengaktifkannya kembali. Proses pembaruan secara otomatis:

Membuat charge untuk sisa kewajiban
Membuat invoice untuk charge tersebut
Memproses pembayaran menggunakan payment method baru
Mengaktifkan kembali subscription ke status active setelah pembayaran berhasil

Subscription dalam status on_hold tidak akan diperbarui secara otomatis. Customer harus memperbarui payment method untuk melunasi kewajiban dan mengaktifkan kembali subscription.

Setelah berhasil memperbarui payment method untuk subscription on_hold, customer akan melihat halaman konfirmasi dan menerima notifikasi email tentang pembayaran yang berhasil serta pengaktifan kembali subscription.

Alur Pembaruan Payment Method

Access subscription details

Klik “Manage subscription” pada subscription aktif mana pun dari halaman beranda portal.

Click Edit on payment method

Klik tombol “Edit” di sebelah payment method untuk membuka antarmuka pembaruan payment method.

Select or add payment method

Pilih payment method tersimpan yang sudah ada atau tambahkan payment method baru dengan memasukkan detail kartu secara aman.

Confirm changes

Konfirmasikan pembaruan. Untuk subscription on_hold, tindakan ini akan secara otomatis membuat charge untuk sisa kewajiban.

Complete payment (if on hold)

Jika subscription ditangguhkan, customer akan diarahkan untuk menyelesaikan pembayaran sisa kewajiban. Setelah pembayaran berhasil, subscription akan diaktifkan kembali secara otomatis.

Confirmation

Customer menerima konfirmasi bahwa payment method telah diperbarui dan, jika berlaku, subscription telah diaktifkan kembali.

Contoh Integrasi

Buat session Customer Portal berbatas waktu untuk customer tertentu melalui API, lalu arahkan pengguna ke URL session tersebut.

const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

Unified Customer Portal

Selain customer portal khusus bisnis, Dodo Payments menawarkan Unified Customer Portal di customer.dodopayments.com, tempat customer dapat melihat dan mengelola semua pembelian serta subscription mereka di berbagai bisnis yang menggunakan Dodo Payments.

Fitur Unified Portal

Visibilitas lintas bisnis: Lihat semua pembelian dan subscription dari merchant Dodo Payments mana pun di satu tempat
Manajemen terpusat: Kelola subscription di berbagai bisnis dari satu dashboard
Riwayat billing terpadu: Akses invoice dan riwayat pembayaran dari semua pembelian
Single sign-on: Login sekali dengan email untuk mengakses pembelian dari semua merchant Dodo Payments

Unified Customer Portal melengkapi portal khusus bisnis. Customer dapat menggunakan merchant portal bermerek atau unified portal sesuai preferensi mereka.

Pemecahan Masalah

Link kedaluwarsa: Buat dan kirim dynamic link baru.
Email tidak dikenali: Minta customer menggunakan email yang terkait dengan pembelian mereka
Subscription ditangguhkan: Jika subscription ditangguhkan, customer harus memperbarui payment method melalui portal untuk melunasi kewajiban dan mengaktifkan kembali subscription. Proses pembaruan akan secara otomatis membebankan biaya untuk sisa kewajiban.
Pembaruan payment method gagal: Jika pembayaran gagal selama proses pembaruan untuk subscription on_hold, subscription akan tetap ditangguhkan. Customer dapat mencoba lagi menggunakan payment method lain.

Design & Theme Customization

Sesuaikan tampilan customer portal dengan theme siap pakai, tipografi, warna, dan live preview dari halaman Design.

Create Portal Session (API)

Subscriptions

​Apa Itu Portal Pelanggan?

​Manfaat Utama

​Metode Akses

​Tautan Statis (akses berbasis email)

​Tautan Dinamis (tautan ajaib)

​Fitur Portal

Active Subscriptions

Payment Methods

Billing History

Billing Information

​Ikhtisar Portal

​Metode Pembayaran & Riwayat Penagihan

​Dukungan Bahasa

​Cara pemilihan bahasa bekerja

​Bahasa yang Didukung

​Perubahan Paket (Upgrade/Downgrade)

​Aksi yang Tersedia

​Cara Kerja Perubahan Paket

​Mengumpulkan Pembayaran Perubahan Plan melalui Payment Link

Plan Change via Payment Link (API)

​Kontrol Bisnis

Product Collections

​Detail Subscription

​Membatalkan Subscription

​Alasan Pembatalan

​Menjeda Subscription

How Pausing Works

​Memperbarui Payment Method

​Mengaktifkan Kembali Subscription yang Ditangguhkan

​Alur Pembaruan Payment Method

​Contoh Integrasi

​Unified Customer Portal

​Fitur Unified Portal

​Pemecahan Masalah

Design & Theme Customization

Apa Itu Portal Pelanggan?

Manfaat Utama

Metode Akses

Tautan Statis (akses berbasis email)

Tautan Dinamis (tautan ajaib)

Fitur Portal

Ikhtisar Portal

Metode Pembayaran & Riwayat Penagihan

Dukungan Bahasa

Cara pemilihan bahasa bekerja

Bahasa yang Didukung

Perubahan Paket (Upgrade/Downgrade)

Aksi yang Tersedia

Cara Kerja Perubahan Paket

Mengumpulkan Pembayaran Perubahan Plan melalui Payment Link

Kontrol Bisnis

Detail Subscription

Membatalkan Subscription

Alasan Pembatalan

Menjeda Subscription

Memperbarui Payment Method

Mengaktifkan Kembali Subscription yang Ditangguhkan

Alur Pembaruan Payment Method

Contoh Integrasi

Unified Customer Portal

Fitur Unified Portal

Pemecahan Masalah