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

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.