Diskon

​

Apa Itu Kode Diskon?

• 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
• Diskon fleksibel: Diskon berbasis persentase atau jumlah tetap
• Kode yang dapat ditumpuk: Terapkan hingga 20 kode per checkout, pembayaran, atau subscription
• Kontrol tertarget: Batasi berdasarkan produk, siklus subscription, dan kelayakan pelanggan
• Tata kelola kampanye: Tanggal mulai terjadwal, tanggal kedaluwarsa, serta batas penggunaan keseluruhan dan per pelanggan
• Harga per mata uang: Tetapkan potongan tetap, batas jumlah, dan subtotal minimum untuk setiap mata uang

​

Pengaturan Dasbor

​

Penyiapan Dashboard

• Nama Diskon (wajib): Label internal untuk dashboard.
• Kode (wajib): String yang dimasukkan pelanggan saat checkout. Buat kode acak atau masukkan kode Anda sendiri (minimal 3 karakter, otomatis diubah menjadi huruf besar).
• Jenis (wajib): Persentase (diskon dalam persentase) atau Jumlah (potongan tetap).
• Jumlah (wajib): Untuk persentase, persentase diskon di dashboard (misalnya, 15 untuk 15%). Melalui API, nilai yang sama dinyatakan dalam basis points (1500). Untuk jumlah, potongan tetap dalam mata uang default kode.
• Tanggal Mulai (opsional): Jadwalkan kode agar aktif pada tanggal mendatang. Biarkan kosong untuk mengaktifkannya segera.
• Tanggal Kedaluwarsa (opsional): Tanggal setelah kode tidak lagi dapat ditukarkan.
• Batas Penggunaan (opsional, di bawah Lanjutan): Jumlah maksimum penukaran oleh semua pelanggan.
• Batas Penggunaan per Pelanggan (opsional, di bawah Lanjutan): Jumlah maksimum penukaran oleh satu pelanggan. Harus kurang dari atau sama dengan batas penggunaan keseluruhan jika keduanya ditetapkan.
• Kelayakan Pelanggan (opsional): Batasi siapa yang dapat menukarkan — semua pelanggan, pelanggan baru, pelanggan yang sudah ada, atau daftar yang dipilih secara manual.
• Opsi Mata Uang (opsional): Jumlah diskon untuk setiap mata uang yang Anda gunakan untuk berjualan. Lihat Opsi per Mata Uang.
• Pembatasan Produk (opsional): Batasi kode ke produk tertentu.
• Batas Siklus Subscription (opsional, di bawah Lanjutan): Jumlah siklus penagihan yang menerima diskon. Biarkan kosong untuk periode tidak terbatas.
• Pertahankan saat Perubahan Paket (opsional): Pertahankan diskon tetap aktif saat subscription berganti paket (preserve_on_plan_change).
• Metadata (opsional): Lampirkan pasangan kunci–nilai khusus untuk pelacakan internal.
• Wajibkan nilai pesanan minimum (opsional, di bawah Lanjutan): Subtotal keranjang minimum (per mata uang) agar kode dapat diterapkan.

​

Jenis Diskon

​

Kelayakan Pelanggan

​

Opsi Per Mata Uang

• Jumlah — untuk diskon Jumlah, potongan tetap dalam mata uang tersebut; untuk diskon Persentase, batas maksimum diskon. Dipetakan ke max_amount_possible dalam API.
• Default — tandai satu mata uang sebagai default. Mata uang yang belum dikonfigurasi dikonversi dari mata uang default ini.

• Subtotal minimum — kode hanya diterapkan jika keranjang mencapai subtotal ini dalam mata uang tersebut. 0 berarti tanpa minimum.

​

Pengalaman Checkout

​

Menumpuk Kode Diskon

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

Pengelolaan API

​

Kasus Penggunaan Umum

• Intro offers: Promosi peluncuran dengan waktu terbatas untuk produk baru
• Bulk or B2B: Diskon berdasarkan kontrak untuk kumpulan produk tertentu
• Retention plays: Kode win-back dalam alur kerja pencegahan churn
• Seasonal campaigns: Promosi berbasis hari raya atau acara

​

Contoh Integrasi

​

Membuat Diskon dengan Metadata

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Menerapkan Diskon dalam Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Menerapkan Diskon Selama Perubahan Paket

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Menyembunyikan Kolom Kode Diskon

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Praktik Terbaik

• Beri nama dengan jelas: Gunakan kode yang mudah dikenali dan sesuai dengan nama kampanye.
• Batasi periode: Tambahkan tanggal kedaluwarsa untuk mendorong urgensi dan mencegah penyalahgunaan.
• Tentukan cakupan dengan bijak: Batasi ke produk tertentu untuk mencegah kebocoran margin.
• Validasi lebih awal: Periksa penerapan kode sebelum mengonfirmasi checkout.
• Pantau dampak: Lacak penggunaan dan konversi berdasarkan kampanye.