Produk adalah dasar dari Dodo Payments. Apakah Anda menjual unduhan sekali pakai, langganan berulang, atau akses berbasis pemakaian, Anda memulainya dengan membuat sebuah produk. Setiap produk menentukan cara penetapan harganya, penyajiannya di halaman checkout, dan pemenuhannya setelah pembelian.
One‑Time
Kenakan biaya sekali untuk akses seumur hidup atau barang tunggal.
Subscriptions
Tagih sesuai jadwal dengan uji coba, prorata, dan tambahan.
Usage‑Based
Ukur konsumsi dan tagih berdasarkan pemakaian sebenarnya.
Buat produk
Anda dapat membuat produk dari dasbor atau melalui API. Pilih model harga di awal, Satu Kali, Langganan, atau Berbasis Penggunaan dan kemudian konfigurasikan detailnya. Model harga tidak dapat diubah setelahnya; buat produk baru jika Anda memerlukan model yang berbeda.Name & description
Berikan judul yang jelas dan deskripsi bernilai singkat. Deskripsi mendukung Markdown.

Pricing model & price
Pilih model harga:
- Satu Kali: Harga tetap dibayar sekali.
- Langganan: Harga berulang dengan interval dan percobaan opsional.
- Berbasis Penggunaan: Harga berasal dari peristiwa yang diukur.
- Harga: Jumlah dasar dan mata uang.
- Diskon (%): Diskon inline opsional yang ditampilkan di checkout dan faktur.
- Untuk langganan, atur Ulang setiap (misalnya, 1 bulan atau 1 tahun) dan Hari Percobaan jika diperlukan.
Product media
Unggah gambar untuk menampilkan produk di checkout dan faktur. Mendukung PNG/JPG/WebP hingga 3 MB. Atur ulang atau ganti kapan saja.
Automated entitlements (Under Advanced Settings)
Lampirkan pemenuhan yang aktif secara otomatis setelah pembayaran:
- Kunci Lisensi: Terbitkan dan validasi kunci unik
- Unduhan File: Berikan akses file yang aman
- Kustom: Picu logika hak Anda sendiri melalui webhook
Varian dan opsi harga
Alih-alih menggunakan varian dalam satu produk, buat produk terpisah untuk setiap opsi harga (misalnya, Bulanan dan Tahunan). Kemudian kelompokkan menjadi Koleksi Produk untuk menghadirkan semua opsi dalam satu pembayaran dan memungkinkan peralihan rencana di Portal Pelanggan.
Mengapa pendekatan ini?
- Model penetapan harga yang jelas: Setiap produk memiliki model penetapan harga yang jelas dan terdefinisi (sekali bayar, langganan, atau berbasis penggunaan)
- API yang dapat diprediksi: Integrasi yang lebih sederhana tanpa logika varian bersarang
- Laporan yang lebih mudah: Melacak pendapatan dan metrik per produk tanpa agregasi varian
- Proses pembayaran yang fleksibel: Tampilkan beberapa produk berdampingan, memungkinkan pelanggan untuk membandingkan dan memilih
Cara kerja Koleksi Produk
- Buat produk: Siapkan produk individual untuk setiap rencana (misalnya, Starter Bulanan, Starter Tahunan, Pro Bulanan, Pro Tahunan)
- Kelompokkan ke dalam koleksi: Tambahkan produk terkait ke dalam Koleksi Produk
- Pembayaran terpadu: Pelanggan melihat semua opsi dalam satu pembayaran dan memilih rencana yang diinginkan
- Pergantian rencana: Pelanggan dapat meningkatkan atau menurunkan antara produk dalam koleksi yang sama melalui Portal Pelanggan
Product Collections
Kelompokkan produk terkait bersama-sama untuk pengalaman checkout terpadu dan jalur naik/turun kelas yang mulus.
Mengelola produk
Anda dapat mengelola produk melalui dasbor atau secara programatis melalui API. API memberikan kontrol penuh atas pembuatan, pembaruan, pengambilan, unggahan gambar, dan pengarsipan produk.Manajemen Dasbor
- Perbarui: Edit nama, deskripsi, gambar, harga, bidang, dan manfaat kapan saja (model penetapan harga tidak dapat diubah).
- Arsip: Sembunyikan produk dari pembelian baru tanpa mengganggu pelanggan yang ada. Anda dapat memperbarui arsip nanti.
Manajemen API
Instruksi berikut memungkinkan Anda untuk membuat, memperbarui, mengelola, dan mengambil produk, termasuk mengunggah gambar.Creating a Product
Creating a Product
Sebuah produk bisa berupa barang satu kali atau layanan berbasis langganan. Untuk membuat produk baru, kirim permintaan
POST ke endpoint /products dengan detail seperti nama, deskripsi, harga, mata uang, dan apakah itu produk berulang.Untuk produk berulang, atur recurring: true dan tentukan billing_cycle (daily, weekly, monthly, yearly).Create Product API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Create Product.
Updating a Product
Updating a Product
Untuk memodifikasi produk yang ada, kirim permintaan
PATCH ke endpoint /products/{product_id}. Anda dapat memperbarui properti seperti nama, harga, dan deskripsi tanpa mengubah detail lainnya.Pastikan product_id di endpoint sesuai dengan produk yang sudah ada.Update Product API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Update Product.
Retrieving Products
Retrieving Products
Anda dapat mengambil daftar produk yang tersimpan di akun Anda menggunakan permintaan
GET ke endpoint /products. Ini memungkinkan Anda mengambil detail produk, termasuk produk aktif dan diarsipkan.Retrieve Products API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Retrieve Products.
Uploading Product Images
Uploading Product Images
Anda dapat mengaitkan gambar dengan produk dengan mengunggahnya ke AWS S3 menggunakan URL bertanda tangan sebelumnya yang disediakan oleh API. Pertama, minta URL unggahan gambar dari endpoint
/products/{product_id}/images, lalu gunakan URL tersebut untuk mengunggah gambar dalam waktu 60 detik.Setelah URL bertanda tangan sebelumnya diterima dari API, unggah gambar menggunakan metode PUT. Ini memastikan akses aman dan sementara ke AWS S3 untuk mengunggah gambar.Perpustakaan yang didukung untuk mengunggah ke S3:- Node.js:
axios,node-fetch - Python:
requests,boto3 - Go:
net/http - PHP:
GuzzleHttp - Ruby:
rest-client
200 OK, menandakan bahwa gambar telah disimpan dengan sukses.Upload Product Image API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Upload Product Image.
Archiving a Product
Archiving a Product
Jika Anda tidak lagi ingin menampilkan atau menggunakan sebuah produk, Anda dapat mengarsipkannya menggunakan permintaan
POST ke endpoint /products/{product_id}/archive. Tindakan ini menyembunyikan produk tetapi tidak menghapusnya secara permanen.Archive Product API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Archive Product.
Unarchiving a Product
Unarchiving a Product
Jika Anda perlu mengembalikan produk yang telah diarsipkan, kirim permintaan
POST ke endpoint /products/{product_id}/unarchive. Ini akan mengaktifkan kembali produk tersebut dan membuatnya dapat digunakan lagi.Unarchive Product API
Lihat struktur permintaan dan respons secara rinci di dokumentasi API Unarchive Product.
Checkout & fulfillment
Checkout & fulfillment
Buat alur pembayaran atau langganan dari produk, dan penuhi secara otomatis melalui manfaat dan webhook.
Praktik terbaik
- Mulai dengan kejelasan: Produk terpisah untuk setiap opsi harga (Bulanan vs Tahunan)
- Gunakan percobaan dengan bijak: Pasangkan percobaan dengan onboarding untuk mendorong aktivasi
- Otomatisasi pemenuhan: Gunakan manfaat dan webhook untuk memberikan secara instan
- Tag dengan metadata: Simpan ID sistem Anda untuk rekonsiliasi
Anda siap untuk membuat produk dan mulai menjual - sekali, berulang, atau berdasarkan pemakaian.
Related
Product Analytics
Lacak pendapatan, pelanggan, retensi, pelanggan yang berlangganan, dan MRR untuk setiap produk individu.