Kupon

Buat kode diskon yang bisa digunakan pelanggan saat checkout. Berupa persentase atau jumlah tetap, dibatasi waktu atau kuota, sekali pakai atau berulang.

Kupon dikelola di Admin > Commerce > Products pada aplikasimu, di bawah tab Coupons, serta di tab Cupones pada panel admin aplikasi yang sudah kamu publikasikan.

Anatomi sebuah kupon

Field	Keterangan
code	Kode promo yang diketik pelanggan saat checkout (misalnya LAUNCH20)
percent_off atau amount_off	Saling eksklusif. Persen bernilai 1–100. Jumlah dinyatakan dalam unit mata uang terkecil (sen).
currency	Wajib diisi untuk diskon amount_off (kode ISO tiga huruf). Diterima saat pembuatan dan diteruskan ke Stripe, tetapi tidak disimpan atau dikembalikan oleh API setelahnya.
duration	once (hanya pembayaran pertama), repeating (selama duration_in_months), atau forever
duration_in_months	Wajib diisi saat duration bernilai repeating
max_redemptions	Total batas penggunaan untuk semua pelanggan
redeem_by	Tanggal kedaluwarsa setelah kupon tidak lagi berlaku
name	Nama tampilan yang ditunjukkan kepada pelanggan
active	Tombol untuk mengaktifkan/menonaktifkan tanpa menghapus

Membuat kupon

Dari sub-tab Coupons, klik Add coupon dan isi field yang tersedia. Beberapa contoh umum:

Tujuan	Pengaturan
Diskon 20% selamanya	percent_off: 20, duration forever
Diskon $10, sekali pakai, kedaluwarsa dalam 30 hari	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by 30 hari ke depan
Diskon 50% untuk 3 bulan pertama langganan	percent_off: 50, duration repeating, duration in months 3

Atau cukup minta ke AI: "Create a LAUNCH20 coupon for 20% off forever."

Menggunakan kupon saat checkout

Ada dua cara pelanggan dapat menggunakan kode promo:

• Di halaman checkout Stripe — kolom kode promo ditampilkan secara otomatis, sehingga pelanggan bisa mengetikkan kodenya di sana tanpa perlu konfigurasi tambahan darimu.
• Di keranjang belanjamu sendiri — tambahkan kolom kode promo ke keranjang dan teruskan apa yang mereka ketik ke dalam panggilan checkout sebagai couponCode. Server akan memvalidasi kode tersebut dan menghitung diskon dari data commerce-mu (bukan dari jumlah yang dikirim browser), mencatatnya pada pesanan, lalu melampirkan kupon Stripe yang sesuai agar tagihan menjadi benar.

Minta ke AI: "Add a promo code field to the cart and apply it at checkout."

Melihat daftar, memperbarui, menonaktifkan

Sub-tab Coupons menampilkan semua kupon beserta berapa kali masing-masing telah digunakan dibandingkan batas kuotanya, sehingga kamu bisa memantau performa kampanye dengan cepat. Pengeditan sengaja dibatasi — lihat penjelasan di bawah — namun kamu dapat menonaktifkan kupon mana pun tanpa menghapusnya, yang langsung menghentikan kupon tersebut dari proses checkout.

Catatan dan batasan

• Kode dan jumlah diskon bersifat tetap (immutable). Kamu hanya bisa memperbarui name sebagai nama tampilan dan mengubah status active, tetapi tidak bisa mengubah percent_off, amount_off, maupun code itu sendiri. Buat kupon baru jika kamu membutuhkan ketentuan yang berbeda.
• times_redeemed bertambah otomatis dan bersifat read-only — berguna untuk melacak performa kampanye.
• Kupon berlaku per pelanggan, bukan per pesanan — jika sebuah kupon berstatus forever dan pelanggan berlangganan, setiap perpanjangan akan mendapatkan diskon tersebut.