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

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

Name & description

Berikan judul yang jelas dan deskripsi bernilai singkat. Deskripsi mendukung Markdown.
Jaga agar kalimat pertama ditujukan kepada pelanggan dan berorientasi pada hasil; kalimat ini muncul secara menonjol di checkout.
Produk
2

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.
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.
Perubahan harga hanya memengaruhi pembelian baru. Langganan eksisting mengikuti aturan perubahan paket.
3

Product media

Unggah gambar untuk menampilkan produk di checkout dan faktur. Mendukung PNG/JPG/WebP hingga 3 MB. Atur ulang atau ganti kapan saja.
4

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
Tambahkan atau hapus manfaat seiring perkembangan penawaran Anda. Pelanggan eksisting akan memperoleh atau kehilangan akses sesuai perubahan tersebut.

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

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.
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.
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.
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.
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.
URL bertanda tangan sebelumnya kedaluwarsa dalam 60 detik, jadi gambar harus diunggah dalam jangka waktu tersebut.
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
Jika unggahan berhasil, AWS S3 akan mengembalikan status 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.
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.
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.

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.

Product Analytics

Lacak pendapatan, pelanggan, retensi, pelanggan yang berlangganan, dan MRR untuk setiap produk individu.