Produk adalah dasar dari Dodo Payments. Apakah Anda menjual unduhan satu kali, langganan berulang, atau akses berbasis penggunaan, Anda mulai dengan membuat produk. Setiap produk mendefinisikan bagaimana harganya, ditampilkan saat checkout, dan dipenuhi setelah pembelian.
Satu Kali
Tarif sekali untuk akses seumur hidup atau satu pengiriman.
Langganan
Tagih secara berkala dengan percobaan, prorata, dan tambahan.
Berbasis Penggunaan
Meter konsumsi dan tagih berdasarkan penggunaan aktual.
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.1
Nama & deskripsi
Berikan judul yang jelas dan deskripsi yang ringkas dan berorientasi nilai. Markdown didukung dalam deskripsi.

2
Model harga & harga
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.
3
Media produk
Unggah gambar untuk menampilkan produk di checkout dan faktur. PNG/JPG/WebP yang didukung hingga 3 MB. Atur ulang atau ganti kapan saja.
4
Hak otomatis (Di Bawah Pengaturan Lanjutan)
Lampirkan pemenuhan yang diaktifkan 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 varian di bawah satu produk, buat produk terpisah untuk setiap opsi harga (misalnya, Bulanan dan Tahunan). Anda dapat menampilkan beberapa produk berdampingan di checkout yang sama dan membiarkan pelanggan beralih di antara mereka.Ini menjaga API tetap dapat diprediksi dan menyederhanakan pelaporan. Setiap produk memiliki satu model harga.
Mengelola produk
Anda dapat mengelola produk melalui dasbor atau secara programatis melalui API. API memberikan kontrol penuh atas pembuatan produk, pembaruan, pengambilan, unggahan gambar, dan pengarsipan.Manajemen Dasbor
- Perbarui: Edit nama, deskripsi, gambar, harga, bidang, dan manfaat kapan saja (model harga tidak dapat diubah).
- Arsip: Sembunyikan produk dari pembelian baru tanpa mengganggu pelanggan yang ada. Anda dapat mengarsipkan kembali nanti.
Manajemen API
Instruksi berikut memungkinkan Anda untuk membuat, memperbarui, mengelola, dan mengambil produk, termasuk mengunggah gambar.Membuat Produk
Membuat Produk
Sebuah produk dapat berupa item 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).API Buat Produk
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Buat Produk.
Memperbarui Produk
Memperbarui Produk
Untuk memodifikasi produk yang ada, kirim permintaan
PATCH ke endpoint /products/{product_id}. Anda dapat memperbarui properti seperti nama, harga, dan deskripsi sambil menjaga detail lainnya tidak berubah.Pastikan bahwa product_id di endpoint cocok dengan produk yang ada.API Perbarui Produk
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Perbarui Produk.
Mengambil Produk
Mengambil Produk
Anda dapat mengambil daftar produk yang disimpan di akun Anda menggunakan permintaan
GET ke endpoint /products. Ini memungkinkan Anda untuk mengambil detail produk, termasuk produk aktif dan diarsipkan.API Ambil Produk
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Ambil Produk.
Mengunggah Gambar Produk
Mengunggah Gambar Produk
Anda dapat mengaitkan gambar dengan produk dengan mengunggahnya ke AWS S3 menggunakan URL yang telah ditandatangani sebelumnya yang disediakan oleh API. Pertama, minta URL unggah gambar dari endpoint
/products/{product_id}/images, kemudian gunakan URL yang diberikan untuk mengunggah gambar dalam waktu 60 detik.Setelah URL yang telah ditandatangani sebelumnya diterima dari API, unggah gambar menggunakan metode PUT. Ini memastikan akses yang 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, yang menunjukkan bahwa gambar telah disimpan dengan sukses.API Unggah Gambar Produk
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Unggah Gambar Produk.
Mengarsipkan Produk
Mengarsipkan Produk
Jika Anda tidak lagi ingin menampilkan atau menggunakan produk, Anda dapat mengarsipkannya menggunakan permintaan
POST ke endpoint /products/{product_id}/archive. Tindakan ini menyembunyikan produk tetapi tidak menghapusnya secara permanen.API Arsip Produk
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Arsip Produk.
Mengembalikan Produk yang Diarsipkan
Mengembalikan Produk yang Diarsipkan
Jika Anda perlu mengembalikan produk yang diarsipkan, kirim permintaan
POST ke endpoint /products/{product_id}/unarchive. Ini akan mengaktifkan kembali produk dan membuatnya tersedia untuk digunakan lagi.API Kembalikan Produk yang Diarsipkan
Lihat struktur permintaan dan respons yang terperinci dalam dokumentasi API Kembalikan Produk yang Diarsipkan.
Checkout & pemenuhan
Checkout & pemenuhan
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 - satu kali, berulang, atau berdasarkan penggunaan.