Diskon

​

Apa Itu Kode Diskon?

• 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
• Diskon fleksibel: Diskon berbasis persentase atau jumlah tetap
• Kode yang dapat ditumpuk: Terapkan hingga 20 kode per checkout, pembayaran, atau subscription — gabungkan kampanye (mis. WELCOME10 + BLACKFRIDAY20) tanpa membuat kode khusus
• 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 pengurangan tetap, batas jumlah, dan subtotal minimum per mata uang
• Checkout tanpa hambatan: Dukungan kolom UI dan API melalui checkout sessions

​

Pengaturan Dasbor

​

Penyiapan dashboard

• Discount Name (wajib): Nama internal dan nama yang ditampilkan di dashboard
• Code (wajib): String yang dimasukkan pelanggan saat checkout, atau buat kode acak menggunakan tombol yang tersedia
• Type (wajib): Pilih Percentage (potongan persentase) atau Amount (pengurangan tetap)
• Amount (wajib): Nilai persentase atau jumlah tetap untuk diskon Amount
• Start Date (opsional): Jadwalkan agar kode menjadi aktif nanti; kosongkan untuk mengaktifkannya segera
• Expiration Date (opsional): Tanggal setelah kode menjadi tidak valid
• Usage Limit (opsional): Jumlah maksimum penukaran oleh seluruh pelanggan
• Per-Customer Usage Limit (opsional): Jumlah maksimum penukaran oleh satu pelanggan. Nilainya harus kurang dari atau sama dengan batas penggunaan keseluruhan jika keduanya ditetapkan
• Customer Eligibility (opsional): Batasi pihak yang dapat menukarkan kode — semua pelanggan, pelanggan baru, pelanggan lama, atau daftar yang dipilih secara manual
• Currency Options (opsional): Nilai per mata uang — lihat Per-Currency Options
• Product Restriction (opsional): Batasi penerapan pada produk yang dipilih
• Subscription Cycle Limit (opsional): Jumlah siklus penagihan yang dikenai diskon
• Preserve on Plan Change (opsional): Pertahankan diskon tetap aktif saat plan subscription berubah (preserve_on_plan_change)
• Metadata (opsional): Tambahkan pasangan key–value khusus untuk pelacakan internal atau integrasi

​

Jenis Diskon

​

Kelayakan Pelanggan

​

Opsi Per Mata Uang

• Amount — untuk diskon Amount, ini adalah pengurangannya; untuk diskon Percentage, ini membatasi jumlah maksimum yang dapat dipotong kode. Dipetakan ke max_amount_possible melalui API.
• Minimum subtotal — kode hanya diterapkan saat cart mencapai subtotal ini. 0 berarti tidak ada minimum.
• Default — satu entri dapat ditandai sebagai default yang menjadi sumber konversi bagi mata uang lain yang belum dikonfigurasi.

​

Pengalaman Checkout

1. Pembeli memasukkan kode di kolom checkout.
2. Diskon yang memenuhi syarat diterapkan dan total segera diperbarui.

​

Menumpuk Kode Diskon

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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

• Penawaran perkenalan: Promosi peluncuran berbatas waktu untuk produk baru
• Volume besar atau B2B: Diskon berdasarkan kontrak untuk kumpulan produk tertentu
• Retensi: Kode win-back dalam alur kerja pencegahan churn
• Kampanye musiman: Promosi berdasarkan hari raya atau acara tertentu

​

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: 'prod_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 saat perubahan plan

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

​

Mengaktifkan input diskon tanpa penerapan awal

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

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