Cara Membuat Checkout ke WhatsApp yang Aman untuk Marketplace Multi-Toko di Google Apps Script
Banyak UMKM sudah terbiasa menerima pesanan lewat WhatsApp. Jadi kalau ingin membuat pasar online untuk satu desa atau komunitas, tidak harus memakai payment gateway. Cukup katalog bersama, lalu pesanan diteruskan ke WhatsApp penjual masing-masing. Masalahnya, checkout lewat WhatsApp gampang dibuat asal-asalan: harga bisa diubah dari browser, stok jebol, dan nomor penjual mudah dipanen bot.
Di tutorial ini kita bahas lima teknik inti dari marketplace multi-toko berbasis Google Apps Script dan Google Sheets, supaya checkout ke WhatsApp tetap aman dan rapi.
1. Pisahkan data publik dan data privat sejak dari server
Sheet Toko menyimpan nomor WhatsApp dan hash PIN penjual. Kalau seluruh baris dikirim ke browser, siapa pun bisa membuka DevTools dan menyalin semua nomor. Karena itu fungsi publik hanya mengembalikan kolom yang memang boleh dilihat:
function publikToko_(t, produk, laku) {
var milik = produk.filter(function (p) { return p.toko === t.id; });
return { id: t.id, nama: t.nama, kota: t.kota, kecamatan: t.kecamatan, deskripsi: t.deskripsi,
kategori: t.kategori, jam: t.jam, layanan: t.layanan, logo: t.logo, unggulan: t.unggulan,
produk: milik.length, terjual: milik.reduce(function (a, p) { return a + (laku[p.id] || 0); }, 0) };
}
Nomor penjual baru diberikan satu per satu, saat pembeli menekan "Chat penjual" (fungsi kontakToko) atau setelah pesanan berhasil dibuat. Dengan begitu bot tidak bisa mengambil semua nomor sekaligus dari satu permintaan.
2. Browser hanya mengirim id, varian, dan jumlah
Jangan pernah percaya harga dari browser. Payload checkout cukup berisi { id, varian, qty }. Server mencari produknya sendiri, lalu memeriksa apakah produk itu masih aktif, milik lapak yang sama, dan variannya valid:
items.forEach(function (it) {
var p = produk[String(it.id || '').toUpperCase()], q = Math.floor(Number(it.qty)), v = bersih_(it.varian, 40);
if (!p || !p.aktif || p.toko !== t.id) throw new Error('Ada produk yang sudah tidak dijual di lapak ini.');
if (p.varian.length && p.varian.indexOf(v) < 0) throw new Error('Pilih varian untuk ' + p.nama + '.');
if (!(q >= 1 && q <= 99)) throw new Error('Jumlah ' + p.nama + ' harus 1 - 99.');
var k = p.id + '|' + v;
if (!gabung[k]) { gabung[k] = 0; urut.push(k); }
gabung[k] += q;
});
Perhatikan gabung: item yang sama dikirim dua kali digabung dulu. Ini menutup trik "kirim satu produk berkali-kali dengan jumlah kecil" untuk melewati pengecekan stok.
3. Kunci stok dengan LockService
Dua pembeli bisa menekan tombol kirim di detik yang sama untuk barang yang tinggal satu. Tanpa kunci, keduanya lolos. Apps Script menyediakan LockService untuk menjadikan bagian baca, cek, dan tulis itu antre satu per satu:
var lock = LockService.getScriptLock();
lock.waitLock(20000);
try {
// baca produk, hitung total per produk, cek stok
Object.keys(perProduk).forEach(function (id) {
var p = produk[id];
if (perProduk[id] > p.stok) throw new Error(p.stok > 0 ? p.nama + ' tinggal ' + p.stok : p.nama + ' sedang habis.');
});
Object.keys(perProduk).forEach(function (pid) { shP.getRange(produk[pid].baris, 8).setValue(produk[pid].stok - perProduk[pid]); });
shO.getRange(shO.getLastRow() + 1, 1, 1, KOL_ORDER.length).setNumberFormat('@').setValues([[/* ... */]]);
SpreadsheetApp.flush();
} finally {
lock.releaseLock();
}
SpreadsheetApp.flush() wajib dipanggil sebelum kunci dilepas supaya pembeli berikutnya membaca stok yang sudah berkurang. Saat penjual membatalkan pesanan, stok dikembalikan lewat jalur yang sama.
4. Susun teks WhatsApp di server
Teks pesanan dibuat oleh server, bukan oleh browser. Hasilnya konsisten dan tidak bisa dipalsukan, misalnya total yang diubah sebelum dikirim:
var teks = ['Halo *' + t.nama + '*, saya mau pesan lewat ' + cfg.nama_pasar + ':', '', 'Kode pesanan: *' + id + '*']
.concat(out.map(function (i, x) { return (x + 1) + '. ' + i.nama + (i.varian ? ' (' + i.varian + ')' : '') + ' x' + i.qty + ' = ' + rp_(i.subtotal); }))
.concat(['', 'Total: *' + rp_(total) + '*', 'Nama: ' + nama, 'Pengambilan: ' + ambil])
.concat(['', 'Cek status: ' + ScriptApp.getService().getUrl() + '?cek=' + id]).join('\n');
Di browser, teks tinggal dibungkus menjadi link https://wa.me/<nomor>?text= + encodeURIComponent(teks). Karena pesanan sudah tercatat di sheet sebelum WhatsApp terbuka, penjual bisa mencocokkan kode yang dikirim pembeli dengan data di panelnya. Catatan: gunakan ScriptApp.getService().getUrl() untuk alamat aplikasi, bukan location.href, karena halaman web app GAS berjalan di dalam iframe sandbox dengan domain berbeda.
5. PIN penjual dan token yang ikut "kedaluwarsa" saat PIN diganti
PIN tidak disimpan mentah. Kita simpan HMAC dari id lapak dan PIN memakai rahasia acak di Script Properties:
function tanda_(isi, extra) { return Utilities.base64EncodeWebSafe(Utilities.computeHmacSha256Signature(isi + '|' + extra, rahasia_())); }
function hashPin_(id, pin) { return tanda_('pin.' + id, String(pin)); }
Setelah PIN benar, server memberi token toko.<id>.<kedaluwarsa>.<tanda>. Bagian tanda dibuat dengan hash PIN sebagai kunci tambahan:
var isi = 'toko.' + t.id + '.' + (Date.now() + 12 * 3600000);
return isi + '.' + tanda_(isi, t.pin);
Akibatnya, begitu PIN diganti atau direset pengelola, semua token lama otomatis tidak cocok lagi. Tidak perlu tabel sesi. Tambahkan juga batas percobaan dengan CacheService (misalnya 6 kali per 15 menit per lapak) agar PIN 6 angka tidak bisa ditebak beruntun.
6. Bonus: ubin produk tanpa foto
Banyak penjual belum punya foto produk yang bagus. Daripada menampilkan gambar kosong, tampilkan blok warna kategori berisi nama produk dengan huruf serif besar. Kalau link foto ada (termasuk link berbagi Google Drive yang diubah ke https://lh3.googleusercontent.com/d/<id>=w800), foto ditampilkan, dan bila gagal dimuat, kembali ke ubin warna lewat onerror. Katalog tetap terlihat rapi sejak hari pertama.
Ringkasan
- Kirim ke browser hanya kolom publik; nomor penjual diberikan per permintaan.
- Browser cukup mengirim id, varian, dan jumlah; harga dan stok dihitung di server.
- Gabungkan item yang sama, lalu cek dan kurangi stok di dalam
LockServicedenganflush(). - Teks WhatsApp disusun server agar konsisten dan tidak bisa dipalsukan.
- Simpan PIN sebagai HMAC dan tandatangani token dengan hash PIN supaya ganti PIN langsung mengakhiri sesi lama.
Download source code lengkapnya
Source code lengkap, termasuk halaman pasar, halaman lapak, keranjang per toko, panel penjual, panel pengelola, data contoh, dan panduan instalasi, bisa diunduh gratis:
Download Source Code Marketplace Multi-Toko Checkout WhatsApp di Papicode
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.