Langsung ke konten utama
Discount codes overview cover
Kode diskon memungkinkan Anda menjalankan promosi dan insentif yang ditargetkan. Buat diskon persentase atau jumlah tetap, atur batas dan tanggal kedaluwarsa, batasi produk, dan terapkan dengan mulus di checkout.

Checkout Sessions

Terapkan kode selama checkout yang dihosting dengan discount_code dan kontrol UI.

Validate Discount

Periksa apakah diskon valid berdasarkan ID-nya.

Get Discount by Code

Cari dan validasi diskon menggunakan nama kode yang dapat dibaca manusia (misalnya “SAVE20”).

Create Discount (API)

Buat kode diskon baru secara programatis.

List & Update Discounts

Telusuri dan kelola diskon yang ada; perbarui atau hapus sesuai kebutuhan.

​
Apa Itu Kode Diskon?

Kode diskon adalah token promosi yang mengurangi total pesanan saat checkout. Mereka ideal untuk:
  • Kampanye musiman: Black Friday, peluncuran produk, atau ulang tahun
  • Tawaran akuisisi: Insentif pembelian pertama atau hadiah rujukan
  • Retensi: Hadiah untuk memenangkan kembali atau loyalitas bagi pelanggan yang ada
  • Kesepakatan B2B: Harga yang dikontrak atau dinegosiasikan melalui kode pribadi

​
Manfaat Utama

  • Diskon fleksibel: Persentase atau jumlah tetap
  • Kontrol terarah: Batasi berdasarkan produk dan siklus langganan
  • Tata kelola kampanye: Tanggal kedaluwarsa dan batas penggunaan
  • Checkout yang mulus: Dukungan UI field dan API melalui sesi checkout

​
Membuat Kode Diskon

Buat kode diskon di dasbor Dodo Payments Anda, lalu terapkan di checkout yang dihosting atau melalui API.

​
Pengaturan Dasbor

  • Nama Diskon (wajib): Nama tampilan internal dan dasbor
  • Kode (wajib): String yang dimasukkan pelanggan saat checkout
  • Tipe & Jumlah (wajib): Tetapkan nilai persentase atau jumlah tetap, atau buat kode acak menggunakan tombol yang disediakan
  • Tanggal Kedaluwarsa (opsional): Tanggal setelah kode menjadi tidak valid
  • Batas Penggunaan (opsional): Total maksimum penukaran di seluruh pelanggan
  • Pembatasan Produk (opsional): Batasi penerapan pada produk yang dipilih
  • Batas Siklus Langganan (opsional): Jumlah siklus penagihan yang berlaku untuk diskon
  • Nama Diskon (wajib): Nama tampilan internal dan di dasbor
  • Kode (wajib): String yang dimasukkan pelanggan saat checkout
  • Jenis & Jumlah (wajib): Tetapkan nilai persentase atau jumlah tetap, atau buat kode acak menggunakan tombol yang disediakan
  • Tanggal Kedaluwarsa (opsional): Tanggal setelah kode menjadi tidak valid
  • Batasan Penggunaan (opsional): Maksimal total penebusan untuk semua pelanggan
  • Pembatasan Produk (opsional): Batasi penerapan pada produk yang dipilih
  • Batas Siklus Berlangganan (opsional): Jumlah siklus penagihan yang berlaku untuk diskon
  • Metadata (opsional): Lampirkan pasangan kunci–nilai kustom untuk pelacakan internal atau integrasi

​
Pengalaman Checkout

  1. Pembeli memasukkan kode di field checkout.
  2. Diskon yang memenuhi syarat diterapkan dan total diperbarui segera.
Dalam Sesi Checkout, kirim discount_code untuk menerapkan kode terlebih dahulu, dan atur feature_flags.allow_discount_code untuk menampilkan bidang input.

​
Manajemen API

Buat kode diskon secara programatis dengan jenis dan jumlah.

API Reference

Lihat API pembuatan diskon.
Daftar semua diskon atau ambil detail untuk manajemen dan audit.

API Reference

Telusuri API daftar dan pengambilan.
Cari diskon menggunakan kode yang dapat dibaca manusia (misalnya “SAVE20”) alih-alih ID internal.

API Reference

Ambil diskon berdasarkan nama kode.
Ubah konfigurasi diskon seperti jumlah, kadaluarsa, atau pembatasan.

API Reference

Pelajari cara memperbarui detail diskon.
Periksa apakah diskon valid dan dapat diterapkan sebelum menerapkannya.

API Reference

Validasi penggunaan diskon.
Nonaktifkan atau hapus diskon yang tidak lagi diperlukan.

API Reference

Hapus diskon.

​
Kasus Penggunaan Umum

  • Tawaran pengantar: Promosi peluncuran terbatas untuk produk baru
  • Diskon massal atau B2B: Diskon yang dikontrak untuk set produk tertentu
  • Strategi retensi: Kode untuk memenangkan kembali dalam alur kerja pencegahan churn
  • Kampanye musiman: Promosi berbasis liburan atau acara

​
Contoh Integrasi

​
Terapkan diskon dalam Sesi Checkout

Terapkan diskon sebelumnya dan tampilkan UI input kode.

​
Buat diskon dengan metadata

Lampirkan pasangan kunci–nilai kustom untuk pelacakan internal. 
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
Gunakan metadata untuk memberi tag diskon berdasarkan kampanye, sumber, atau ID referensi internal sehingga Anda dapat merekonsiliasi penggunaan dan mengukur ROI di kemudian hari.

​
Terapkan diskon di Sesi Checkout

Terapkan diskon terlebih dahulu dan tampilkan UI input kode. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
Terapkan diskon selama perubahan paket

Tawarkan harga promosi saat pelanggan meningkatkan atau menurunkan langganan mereka. 
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
Jika langganan sudah memiliki diskon dengan preserve_on_plan_change=true dan Anda tidak melewatkan kode baru, diskon yang ada secara otomatis dipertahankan ketika berlaku untuk produk baru.

​
Aktifkan entri diskon tanpa penerapan awal

Izinkan pelanggan memasukkan kode di checkout tanpa melewatkan kode di muka. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
Praktik Terbaik

  • Namai dengan jelas: Gunakan kode yang mudah dikenali yang sesuai dengan nama kampanye
  • Beri batas waktu: Tambahkan kedaluwarsa untuk mendorong urgensi dan mencegah penyalahgunaan
  • Jangkau dengan bijak: Batasi pada produk tertentu untuk menghindari kebocoran margin
  • Validasi lebih awal: Periksa penerapan kode sebelum mengonfirmasi checkout
  • Pantau dampaknya: Lacak penggunaan dan konversi berdasarkan kampanye
Kode diskon adalah alat yang kuat untuk akuisisi dan retensi. Mulailah dengan penawaran yang sederhana dan bernama baik, validasi dengan cermat, dan iterasi berdasarkan kinerja.
Last modified on April 20, 2026