2026-11-27 · 9 min
Logika Voucher Diskon E-commerce: dari Pembeli ke Kode
Kami desk pemburu diskon. Sudah bertahun-tahun kami hafal aturan voucher di luar kepala, dan hari ini, Black Friday 2026, kami membaliknya: aturan yang kami hafal sebagai pembeli, kami tulis sebagai test case. Hasilnya artikel tentang logika voucher diskon e-commerce yang bisa langsung Anda jadikan spesifikasi sebelum menulis fungsinya.
Catatan dulu: semua nominal di bawah ilustratif, tidak mewakili merchant mana pun. Kodenya pseudo-TypeScript, tanpa pembahasan arsitektur, cukup fungsi murni dan tabel test.
Aturan yang kami hafal sebagai pembeli
Ini daftar yang selalu kami cek sebelum menekan tombol bayar:
- Minimum belanja. Belanja tepat di ambang biasanya lolos. Kurang Rp1 saja ditolak.
- Persentase dengan batas maksimal. Diskon 10 persen, maksimal Rp15.000. Belanja besar tidak membuat potongan membengkak.
- Pembulatan. Potongan jatuh di pecahan rupiah? Dibulatkan ke bawah, sehingga toko tidak pernah rugi sepersen.
- Tidak boleh digabung. Voucher bertanda eksklusif menolak voucher lain.
- Cashback koin. Koin masuk setelah transaksi, tidak memotong jumlah bayar.
- Urutan penumpukan. Diskon produk, lalu voucher toko, lalu voucher ongkir.
Poin 6 perlu dicetak tebal: tiap marketplace menetapkan urutannya sendiri. Yang kami pakai di sini hanya satu contoh yang bisa dikonfigurasi, bukan kebenaran universal.
Tabel aturan, bukan prosa
Sebelum satu baris kode, ubah daftar tadi menjadi tabel kasus. Angka di bawah mengasumsikan voucher toko 10 persen (minimum Rp100.000, maksimal Rp15.000) dan ongkir Rp15.000.
| Kasus | Belanja | Hasil |
|---|---|---|
| Kurang Rp1 dari ambang | 99.999 | ditolak |
| Persis di ambang | 100.000 | potongan 10.000, bayar 105.000 |
| Kena batas maksimal | 200.000 | potongan 15.000 (bukan 20.000), bayar 200.000 |
| Pembulatan | 100.005 dengan 15 persen | potongan 15.000 (bukan 15.000,75), bayar 100.005 |
| Minimum dihitung setelah diskon produk | 150.000 dikurangi diskon produk 60.000 | ditolak, sisa 90.000 |
| Voucher eksklusif digabung voucher ongkir | 200.000 | ditolak |
| Cashback koin 5 persen, maksimal 10.000 | 200.000 | koin 10.000, bayar tetap 215.000 |
Satu baris tabel, satu test. Itu seluruh metodenya.
Fungsi murni dengan rupiah integer
Semua angka adalah integer rupiah. Tidak ada desimal, tidak ada akses database, tidak ada jam sistem.
type Rupiah = number; // selalu integer
type Voucher =
| { kind: "toko"; kode: string; minBelanja: Rupiah;
persen?: number; potonganTetap?: Rupiah;
maksPotongan?: Rupiah; eksklusif?: boolean }
| { kind: "ongkir"; kode: string; minBelanja: Rupiah;
maksPotongan: Rupiah; eksklusif?: boolean };
type Keranjang = { subtotalProduk: Rupiah; diskonProduk: Rupiah; ongkir: Rupiah };
// Contoh konfigurasi. Marketplace lain bisa memilih dasar yang berbeda.
type Opsi = { dasarMinOngkir: "setelahToko" | "setelahProduk" };
type Hasil =
| { ok: true; potonganToko: Rupiah; potonganOngkir: Rupiah; bayar: Rupiah; koin: Rupiah }
| { ok: false; alasan: string };
function potonganToko(v: Extract<Voucher, { kind: "toko" }>, dasar: Rupiah): Rupiah {
const mentah = v.persen !== undefined
? Math.floor((dasar * v.persen) / 100) // bulatkan ke bawah
: (v.potonganTetap ?? 0);
return Math.min(mentah, v.maksPotongan ?? Infinity, dasar); // tak pernah > dasar
}
export function hitungCheckout(
k: Keranjang, vouchers: Voucher[],
koin = { persen: 0, maks: 0 },
opsi: Opsi = { dasarMinOngkir: "setelahToko" },
): Hasil {
if (vouchers.length > 1 && vouchers.some((v) => v.eksklusif))
return { ok: false, alasan: "voucher tidak bisa digabung" };
const toko = vouchers.filter((v) => v.kind === "toko");
const ongkir = vouchers.filter((v) => v.kind === "ongkir");
if (toko.length > 1 || ongkir.length > 1)
return { ok: false, alasan: "satu voucher per jenis" };
// 1) diskon produk
const setelahProduk = k.subtotalProduk - k.diskonProduk;
// 2) voucher toko
let potTk = 0;
if (toko[0]) {
if (setelahProduk < toko[0].minBelanja)
return { ok: false, alasan: "belum mencapai minimum belanja" };
potTk = potonganToko(toko[0], setelahProduk);
}
const setelahToko = setelahProduk - potTk;
// 3) voucher ongkir
let potOngkir = 0;
if (ongkir[0]) {
const dasar = opsi.dasarMinOngkir === "setelahToko" ? setelahToko : setelahProduk;
if (dasar < ongkir[0].minBelanja)
return { ok: false, alasan: "belum mencapai minimum belanja" };
potOngkir = Math.min(ongkir[0].maksPotongan, k.ongkir);
}
const bayar = setelahToko + k.ongkir - potOngkir;
// cashback koin: dihitung terpisah, tidak menyentuh `bayar`
const jumlahKoin = Math.min(Math.floor((setelahToko * koin.persen) / 100), koin.maks);
return { ok: true, potonganToko: potTk, potonganOngkir: potOngkir, bayar, koin: jumlahKoin };
}
Perhatikan Math.min tiga argumen di potonganToko: potongan mentah, batas maksimal, dan dasar belanja. Argumen ketiga mencegah total bayar minus untuk voucher potongan tetap yang lebih besar dari belanja.
Test Vitest yang diturunkan langsung dari tabel
Tiap baris tabel jadi satu entri. Kalau aturan berubah, ubah tabelnya dulu, baru kodenya.
import { describe, it, expect } from "vitest";
import { hitungCheckout } from "./voucher";
const toko = { kind: "toko", kode: "TOKO10", minBelanja: 100_000, persen: 10, maksPotongan: 15_000 } as const;
const ongkirV = { kind: "ongkir", kode: "ONGKIR", minBelanja: 0, maksPotongan: 20_000 } as const;
const base = { subtotalProduk: 200_000, diskonProduk: 0, ongkir: 15_000 };
describe("voucher toko", () => {
it.each([
["kurang Rp1 dari ambang", { ...base, subtotalProduk: 99_999 }, toko, false, 0, 0],
["persis di ambang", { ...base, subtotalProduk: 100_000 }, toko, true, 10_000, 105_000],
["kena batas maksimal", base, toko, true, 15_000, 200_000],
["pembulatan ke bawah", { ...base, subtotalProduk: 100_005 },
{ ...toko, persen: 15, maksPotongan: 99_999 }, true, 15_000, 100_005],
["minimum setelah diskon produk",
{ ...base, subtotalProduk: 150_000, diskonProduk: 60_000 }, toko, false, 0, 0],
])("%s", (_nama, keranjang, v, ok, potongan, bayar) => {
const r = hitungCheckout(keranjang, [v]);
expect(r.ok).toBe(ok);
if (r.ok) {
expect(r.potonganToko).toBe(potongan);
expect(r.bayar).toBe(bayar);
}
});
});
describe("gabungan, ongkir, dan koin", () => {
it("voucher eksklusif menolak voucher lain", () => {
expect(hitungCheckout(base, [{ ...toko, eksklusif: true }, ongkirV]).ok).toBe(false);
});
it("voucher ongkir tidak melebihi ongkos kirim", () => {
const r = hitungCheckout(base, [ongkirV]);
expect(r.ok && r.potonganOngkir).toBe(15_000);
expect(r.ok && r.bayar).toBe(200_000);
});
it("koin tidak memotong jumlah bayar", () => {
const tanpa = hitungCheckout(base, []);
const dengan = hitungCheckout(base, [], { persen: 5, maks: 10_000 });
expect(dengan.ok && dengan.koin).toBe(10_000);
expect(dengan.ok && dengan.bayar).toBe(tanpa.ok && tanpa.bayar); // 215.000
});
it("koin dibulatkan ke bawah", () => {
const r = hitungCheckout({ ...base, subtotalProduk: 100_010 }, [], { persen: 5, maks: 10_000 });
expect(r.ok && r.koin).toBe(5_000); // 5.000,5 jadi 5.000
});
});
Urutan penumpukan: satu contoh, bukan hukum
Urutan di kode kami: diskon produk, voucher toko, voucher ongkir. Efeknya terasa di minimum belanja. Dengan dasarMinOngkir: "setelahToko", voucher ongkir yang mensyaratkan minimum Rp190.000 gagal untuk belanja Rp200.000 yang sudah kena voucher toko Rp15.000 (sisa 185.000). Dengan "setelahProduk", voucher yang sama lolos.
Marketplace A boleh memakai urutan pertama, marketplace B yang kedua, dan keduanya benar menurut aturannya sendiri. Karena itu, tambahkan satu test per pilihan konfigurasi:
it("dasar minimum ongkir ikut konfigurasi", () => {
const v = { ...ongkirV, minBelanja: 190_000 };
expect(hitungCheckout(base, [toko, v]).ok).toBe(false);
expect(hitungCheckout(base, [toko, v], undefined, { dasarMinOngkir: "setelahProduk" }).ok).toBe(true);
});
Checklist kasus tepi sebelum rilis
- Belanja persis di ambang minimum dan kurang Rp1.
- Potongan persentase yang tepat menyentuh batas maksimal.
- Potongan berpecahan rupiah (arah pembulatan tertulis di test).
- Voucher potongan tetap lebih besar dari belanja.
- Voucher eksklusif ditumpuk dengan voucher lain.
- Diskon produk membuat belanja turun di bawah minimum.
- Koin dengan dan tanpa voucher: total bayar tidak berubah.
Penutup: kuota voucher itu urusan lain
Fungsi di atas hanya menjawab “berapa potongannya”. Soal “voucher ini masih ada jatahnya atau tidak” adalah masalah konkurensi, dan tidak kami bahas di sini. Pola yang sama dengan stok flash sale berlaku: klaim jatah secara atomic. Baca Cegah Overselling Flash Sale: Stok Atomic di PostgreSQL & Redis untuk caranya, lalu pasang fungsi hitung di atas sebagai langkah sebelum klaim.
Selamat berburu, dan selamat menulis test, di Black Friday 2026.
Ditulis oleh Tim Diskon Melulu