16 November 2026
Tutorial Roblox

Panduan Lengkap Membuat Developer Products dan Fungsi ProcessReceipt di Roblox Studio untuk Penjualan Koin, Potion, dan Item Habis Pakai

Panduan Lengkap Membuat Developer Products dan Fungsi ProcessReceipt di Roblox Studio untuk Penjualan Koin, Potion, dan Item Habis Pakai
Alur verifikasi transaksi pembelian Developer Products menggunakan ProcessReceipt di Roblox Studio

Dalam merancang sistem monetisasi game di Roblox Studio, terdapat dua jenis produk berbayar utama: Gamepass dan Developer Products (DevProducts). Jika Gamepass hanya dapat dibeli satu kali seumur hidup oleh seorang pemain untuk membuka kemampuan permanen, maka Developer Products dirancang khusus untuk barang habis pakai (consumables) yang dapat dibeli berulang kali, seperti paket koin emas, permata (Gems), ramuan pengganda EXP selama 30 menit, atau nyawa tambahan (Revive).

Namun, menangani transaksi Developer Products memerlukan ketelitian tingkat tinggi di sisi server. Jika pemain sudah dipotong saldo Robux-nya tetapi server tiba-tiba tertutup sebelum koin berhasil disimpan ke database, pemain akan merasa dirugikan. Oleh karena itu, Roblox mewajibkan penggunaan callback khusus bernama MarketplaceService.ProcessReceipt yang menjamin setiap pembelian tercatat tuntas sebelum transaksi dinyatakan selesai.

1. Cara Membuat Developer Product di Creator Dashboard dan Menyalin Product ID

Langkah pertama sebelum menulis kode pembelian adalah mendaftarkan produk habis pakai Anda di halaman pengelolaan game:

  1. Buka proyek game Anda di Roblox Studio atau masuk ke halaman Creator Hub (create.roblox.com).
  2. Pilih pengalaman (Experience) Anda, lalu masuk ke menu Monetization → Developer Products di bilah navigasi kiri.
  3. Klik tombol Create a Developer Product, unggah ikon produk berukuran 512x512 piksel, isi nama (misalnya Paket 1.000 Koin Emas), dan tentukan harga dalam satuan Robux.
  4. Setelah produk disimpan, klik menu titik tiga pada kartu produk tersebut lalu pilih Copy Asset ID untuk mendapatkan angka ProductId uniknya.

2. Memunculkan Jendela Pembelian dari Tombol GUI Menggunakan PromptProductPurchase

Untuk memunculkan jendela konfirmasi pembelian resmi Roblox saat pemain menekan tombol di toko dalam game (In-Game Shop), gunakan metode PromptProductPurchase(player, productId) di dalam LocalScript pada tombol GUI:

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local tombolBeli = script.Parent
local ID_PRODUK_1000_KOIN = 123456789 -- Ganti dengan ProductId Anda

tombolBeli.Activated:Connect(function()
    MarketplaceService:PromptProductPurchase(player, ID_PRODUK_1000_KOIN)
end)

3. Memahami Aturan Emas MarketplaceService.ProcessReceipt

Ada dua aturan mutlak yang wajib dipatuhi saat menulis MarketplaceService.ProcessReceipt di proyek game Anda:

  • Hanya Boleh Ada SATU Fungsi ProcessReceipt di Seluruh Game: Jika Anda membuat dua Script berbeda yang sama-sama menetapkan MarketplaceService.ProcessReceipt = ..., maka script kedua akan menimpa dan mematikan script pertama! Satukan seluruh daftar ProductId di dalam satu tabel Handler terpusat.
  • Kembalikan PurchaseGranted Hanya Setelah Data Tersimpan: Fungsi ini wajib mengembalikan nilai Enum.ProductPurchaseDecision.PurchaseGranted jika hadiah berhasil diberikan, atau Enum.ProductPurchaseDecision.NotProcessedYet jika terjadi gangguan penyimpanan sehingga Roblox akan otomatis mencoba memanggil ulang fungsi ini ketika pemain masuk kembali ke server.

4. Script Server ProcessReceipt Lengkap dengan Pengaman Anti-Duplikasi PurchaseId

Buatlah sebuah Script bernama DevProductReceiptManager di dalam ServerScriptService yang memproses berbagai paket produk sekaligus menyimpan riwayat PurchaseId di DataStoreService:

local MarketplaceService = game:GetService("MarketplaceService")
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

local riwayatTransaksiStore = DataStoreService:GetDataStore("RiwayatStrukPembelian_V1")

-- Daftar fungsi hadiah berdasarkan ProductId
local daftarProduk = {
    [123456789] = function(player)
        -- Tambah 1.000 Koin
        local leaderstats = player:FindFirstChild("leaderstats")
        local koin = leaderstats and leaderstats:FindFirstChild("Koin")
        if koin then
            koin.Value += 1000
            return true
        end
        return false
    end,
    [987654321] = function(player)
        -- Tambah 5.000 Koin + Bonus
        local leaderstats = player:FindFirstChild("leaderstats")
        local koin = leaderstats and leaderstats:FindFirstChild("Koin")
        if koin then
            koin.Value += 5500
            return true
        end
        return false
    end
}

MarketplaceService.ProcessReceipt = function(receiptInfo)
    local kunciStruk = tostring(receiptInfo.PlayerId) .. "_" .. tostring(receiptInfo.PurchaseId)

    -- 1. Cek apakah struk ini sudah pernah diproses sebelumnya
    local suksesBaca, sudahDiproses = pcall(function()
        return riwayatTransaksiStore:GetAsync(kunciStruk)
    end)
    if suksesBaca and sudahDiproses then
        return Enum.ProductPurchaseDecision.PurchaseGranted
    end

    -- 2. Cari pemain yang sedang online di server
    local player = Players:GetPlayerByUserId(receiptInfo.PlayerId)
    if not player then
        return Enum.ProductPurchaseDecision.NotProcessedYet
    end

    -- 3. Jalankan fungsi pemberian hadiah sesuai ProductId
    local fungsiHadiah = daftarProduk[receiptInfo.ProductId]
    if fungsiHadiah then
        local okHadiah, berhasilDiberikan = pcall(fungsiHadiah, player)
        if not okHadiah or not berhasilDiberikan then
            return Enum.ProductPurchaseDecision.NotProcessedYet
        end
    end

    -- 4. Catat PurchaseId ke DataStore agar tidak diberikan dua kali
    local suksesSimpan = pcall(function()
        riwayatTransaksiStore:SetAsync(kunciStruk, true)
    end)
    if not suksesSimpan then
        return Enum.ProductPurchaseDecision.NotProcessedYet
    end

    return Enum.ProductPurchaseDecision.PurchaseGranted
end

5. Menguji Pembelian Tanpa Kehilangan Robux di Mode Uji Roblox Studio

Ketika Anda menjalankan pengujian (Play Test) di dalam Roblox Studio dan menekan tombol beli Developer Product, Roblox akan menampilkan kotak dialog bertuliskan Test Purchase: This is a test purchase; your account will not be charged. Anda dapat menguji seluruh skenario keberhasilan maupun kegagalan transaksi secara gratis sebelum mempublikasikan game ke publik.

6. Pengamanan Sisi Server (Server Authority) dan Pencegahan Eksploitasi pada Sistem Transaksi Developer Products dan Callback ProcessReceipt

Ketika mengimplementasikan Sistem Transaksi Developer Products dan Callback ProcessReceipt di dalam permainan multipemain yang sesungguhnya, kita tidak boleh hanya berfokus pada fungsionalitas semata, melainkan juga wajib menerapkan prinsip Server Authority (Otoritas Server Penuh). Di ekosistem Roblox, perangkat pemain (Client) hanya bertugas menangkap input tombol serta menampilkan efek visual di layar, sedangkan seluruh keputusan penting yang memengaruhi logika permainan, saldo mata uang, posisi sah, maupun status inventaris harus divalidasi sepenuhnya oleh Script di dalam ServerScriptService.

Dalam konteks penggunaan MarketplaceService, PromptProductPurchase, ProcessReceipt, Enum.ProductPurchaseDecision, dan PurchaseId, terdapat empat lapis pertahanan utama yang selalu diterapkan oleh pengembang profesional:

  • Pemeriksaan Tipe Data (Type Checking) pada RemoteEvent: Setiap parameter yang dikirimkan dari LocalScript menuju server wajib diperiksa menggunakan fungsi typeof(nilai) untuk mencegah pengiriman nilai nil, angka NaN (Not a Number), atau tabel palsu yang sengaja disuntikkan untuk memicu error pada script server.
  • Pembatasan Frekuensi Permintaan (Server-Side Rate Limiting): Simpan tabel waktu pemanggilan terakhir menggunakan os.clock() untuk setiap objek Player. Apabila seorang pemain mengirimkan sinyal pemicu lebih cepat dari batas kewajaran (misalnya puluhan kali per detik), abaikan permintaan tersebut sebelum memproses logika berat.
  • Validasi Jarak dan Status Karakter: Sebelum mengeksekusi aksi yang berkaitan dengan Sistem Transaksi Developer Products dan Callback ProcessReceipt, pastikan karakter pemain benar-benar masih hidup (Humanoid.Health > 0) dan berada dalam jarak fisik yang masuk akal dari objek interaksi.
  • Pembersihan Referensi Tabel Saat Pemain Keluar: Selalu hubungkan event Players.PlayerRemoving untuk menghapus data sementara milik pemain yang telah meninggalkan server agar penggunaan memori RAM server tetap stabil meskipun server telah menyala selama berjam-jam.

7. Teknik Debugging dan Pengujian Simulasi Multi-Pemain di Roblox Studio

Untuk memastikan bahwa sistem Sistem Transaksi Developer Products dan Callback ProcessReceipt yang telah Anda rancang berjalan mulus tanpa kendala sinkronisasi di antara banyak pemain, lakukan tahapan pengujian terstruktur berikut sebelum mempublikasikan pembaruan ke publik:

  1. Buka tab menu Test di bagian atas jendela Roblox Studio, lalu pada panel Clients and Servers pilih simulasi 2 Players atau 3 Players dan tekan tombol Start.
  2. Amati jendela Output baik pada jendela Server maupun masing-masing jendela Client saat kedua pemain berinteraksi dengan sistem Sistem Transaksi Developer Products dan Callback ProcessReceipt secara bersamaan. Pastikan tidak ada peringatan Infinite yield possible maupun pesan error merah.
  3. Buka jendela Developer Console (F9) dan pilih tab Memory serta Scripts untuk memeriksa apakah rata-rata aktivitas script tetap berada di bawah ambang batas 2% dan konsumsi memori tidak terus membengkak seiring berjalannya waktu.
  4. Gunakan fitur Device Emulation (ikon ponsel di pojok kanan atas layar viewport) untuk memilih profil Phone atau Tablet guna memastikan antarmuka dan kontrol untuk Sistem Transaksi Developer Products dan Callback ProcessReceipt tetap nyaman dioperasikan pada layar sentuh berukuran kecil.

8. Daftar Periksa (Checklist) Optimasi dan Kualitas Sebelum Publikasi

Sebelum Anda menekan menu File → Publish to Roblox dan merilis fitur Sistem Transaksi Developer Products dan Callback ProcessReceipt ke server utama, pastikan seluruh poin pada daftar periksa kualitas berikut telah terpenuhi:

  • Penanganan Error Jaringan dengan pcall(): Seluruh pemanggilan API yang berkomunikasi dengan layanan cloud Roblox pada MarketplaceService, PromptProductPurchase, ProcessReceipt, Enum.ProductPurchaseDecision, dan PurchaseId telah dibungkus di dalam blok pcall() lengkap dengan mekanisme percobaan ulang (Retry Backoff) apabila terjadi gangguan jaringan sesaat.
  • Umpan Balik Visual dan Audio (Game Feel): Pemain langsung mendapatkan konfirmasi jelas berupa perubahan warna indikator, animasi transisi halus, atau efek suara pendek setiap kali sistem merespons tindakan mereka.
  • Kompatibilitas StreamingEnabled: Apabila tempat permainan Anda mengaktifkan fitur Workspace.StreamingEnabled = true untuk menghemat memori di HP, pastikan script di sisi Client menggunakan WaitForChild() atau memantau sinyal CollectionService:GetInstanceAddedSignal() ketika mengakses objek 3D yang baru dimuat.
  • Struktur Hierarki dan Penamaan yang Konsisten: Kelompokkan setiap modul, event komunikasi, dan aset pendukung ke dalam folder yang rapi di dalam ReplicatedStorage serta ServerScriptService agar mudah dikembangkan kembali pada pembaruan berikutnya.

9. Pertanyaan yang Sering Diajukan (FAQ) Seputar Sistem Transaksi Developer Products dan Callback ProcessReceipt

Apakah sistem Sistem Transaksi Developer Products dan Callback ProcessReceipt ini kompatibel untuk game dengan karakter R6 maupun R15?

Ya, seluruh arsitektur kode Luau dan pemanfaatan komponen MarketplaceService, PromptProductPurchase, ProcessReceipt, Enum.ProductPurchaseDecision, dan PurchaseId dalam panduan ini dapat diterapkan baik pada proyek game bertipe avatar klasik R6 maupun avatar modern R15. Untuk fitur yang menyentuh persendian spesifik seperti animasi prosedural atau efek fisik tubuh, kode secara otomatis memeriksa keberadaan objek turunan sehingga tetap aman dijalankan pada berbagai bentuk karakter.

Mengapa fitur berfungsi normal saat diuji di Roblox Studio, tetapi gagal berjalan ketika dimainkan di aplikasi Roblox?

Ada tiga penyebab utama yang paling sering terjadi: pertama, Anda belum mengaktifkan izin Enable Studio Access to API Services di menu Game Settings → Security; kedua, perubahan terakhir hanya disimpan ke file lokal (Save) dan belum dikirim ke server publik melalui menu File → Publish to Roblox; atau ketiga, LocalScript mencoba membaca objek di dalam Workspace sebelum objek tersebut selesai diunduh oleh perangkat pemain.

Bagaimana cara menjaga agar performa FPS tetap stabil di perangkat Android spesifikasi rendah saat fitur ini aktif?

Pastikan perhitungan logika berulang tidak dijalankan setiap frame di sisi server jika cukup dipicu melalui sinyal Event-Driven (seperti GetPropertyChangedSignal atau event interaksi), serta batasi pembaruan efek visual murni hanya di dalam LocalScript pada jarak pandang kamera terdekat pemain.

Kesimpulan

Menguasai pembuatan dan pengelolaan Sistem Transaksi Developer Products dan Callback ProcessReceipt dengan memaksimalkan kemampuan MarketplaceService, PromptProductPurchase, ProcessReceipt, Enum.ProductPurchaseDecision, dan PurchaseId secara tepat merupakan investasi keterampilan yang sangat berharga bagi setiap kreator di Roblox Studio. Dengan menggabungkan penulisan kode Luau yang terstruktur, validasi keamanan berlapis di sisi server, serta pengujian performa lintas perangkat, Anda dapat menghadirkan mekanik permainan berstandar profesional yang disukai oleh komunitas pemain dan siap bersaing di halaman utama Roblox.

R
Editor Utama & Praktisi Web

Redaksi SemogaBermanfaat

Tim penulis dan praktisi teknologi di SemogaBermanfaat.com yang berfokus membagikan tutorial blogging, optimasi SEO, pemrograman web, dan literasi digital secara mendalam dan terstruktur.

Komentar Pembaca (0)

Belum ada komentar. Jadilah yang pertama memberikan tanggapan pada artikel ini!