Langsung ke konten utama
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.

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.
Jaga kalimat pertama agar berfokus pada pelanggan dan berorientasi pada hasil; itu muncul secara mencolok di checkout.
Produk
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.
Kemudian atur harga:
  • 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.
Mengubah harga hanya mempengaruhi pembelian baru. Langganan yang ada mengikuti aturan perubahan rencana.
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
Tambahkan atau hapus manfaat seiring dengan perkembangan penawaran Anda. Pelanggan yang ada mendapatkan atau kehilangan akses sesuai dengan itu.

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.
Koleksi Produk

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

  1. Buat produk: Siapkan produk individual untuk setiap rencana (misalnya, Starter Bulanan, Starter Tahunan, Pro Bulanan, Pro Tahunan)
  2. Kelompokkan ke dalam koleksi: Tambahkan produk terkait ke dalam Koleksi Produk
  3. Pembayaran terpadu: Pelanggan melihat semua opsi dalam satu pembayaran dan memilih rencana yang diinginkan
  4. Pergantian rencana: Pelanggan dapat meningkatkan atau menurunkan antara produk dalam koleksi yang sama melalui Portal Pelanggan

Koleksi Produk

Kelompokkan produk terkait untuk pengalaman pembayaran terpadu dan jalur peningkatan/penurunan 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.
Sebuah produk dapat menjadi item sekali bayar 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 yang berulang.Untuk produk yang berulang, set recurring: true dan spesifikasikan billing_cycle (daily, weekly, monthly, yearly).

API Buat Produk

Lihat struktur permintaan dan respons yang detail dalam dokumentasi API Buat Produk.
Untuk memodifikasi produk yang ada, kirim permintaan PATCH ke endpoint /products/{product_id}. Anda dapat memperbarui properti seperti nama, harga, dan deskripsi sambil mempertahankan detail lainnya tanpa berubah.Pastikan bahwa product_id di endpoint cocok dengan produk yang ada.

API Perbarui Produk

Lihat struktur permintaan dan respons yang detail dalam dokumentasi API Perbarui 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 yang diarsipkan.

API Ambil Produk

Lihat struktur permintaan dan respons yang detail dalam dokumentasi API Ambil Produk.
Anda dapat mengasosiasikan gambar dengan produk dengan mengunggahnya ke AWS S3 menggunakan URL yang sudah 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 60 detik.
URL yang sudah ditandatangani sebelumnya kedaluwarsa dalam 60 detik, jadi gambar harus diunggah dalam jangka waktu tersebut.
Setelah URL yang sudah 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
Jika unggahan berhasil, AWS S3 akan mengembalikan status 200 OK, yang menunjukkan bahwa gambar telah disimpan dengan berhasil.

API Unggah Gambar Produk

Lihat struktur permintaan dan respons yang detail dalam dokumentasi API Unggah Gambar Produk.
Jika Anda tidak ingin lagi 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 detail dalam dokumentasi API Arsip Produk.
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 Batalkan Arsip Produk

Lihat struktur permintaan dan respons yang detail dalam dokumentasi API Batalkan Arsip Produk.

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.