Developer Products – In‑Game Purchases

10 min

Developer products are items which players can buy more than once, making them perfect for in-game currency, ammo, or similar purchases.

For items or abilities that a player might purchase just once, such as a special weapon or a permanent power-up, please refer to Articles/Game Passes One Time Purchases|Game Passes.

Creating a Developer Product

To create a new developer product:

In Roblox Studio, click on the Game Settings button from the Home tab.

Select the Monetization tab.
Next to Developer Products, click the Create button.

For the new placeholder product, click the button and select Edit.

Specify the product’s name and the price.
Click the Save button.

After creating a developer product, Roblox assigns it a unique ID and all products are neatly listed in the Monetization tab.

Scripting for Developer Products

To take full advantage of developer products, you’ll need to use scripting. Here are some common examples:

Getting a Game’s Developer Products

To gather data for all of the developer products in a game, use the MarketplaceService/GetDeveloperProductsAsync|GetDeveloperProductsAsync() method. This returns a Pages object that you can inspect and filter to build an in-game store, product list GUI, etc.

Getting Product Info

To get information (price, name, image, etc.) for a specific product, use the MarketplaceService/GetProductInfo|GetProductInfo() function with a second argument:

			
				Expected Output
			
				Expand
				
			local MarketplaceService = game:GetService("MarketplaceService")

local productID = 0000000  -- Change this to your developer product ID

local productInfo = MarketplaceService:GetProductInfo(productID, Enum.InfoType.Product)
		
				Copy Code
			
				Light Theme

Prompting a Purchase

You can prompt a player to purchase one of your developer products with the MarketplaceService/PromptProductPurchase|PromptProductPurchase() method of MarketplaceService. In the following code, the promptPurchase() function can be called when the player presses a Articles/Creating GUI Buttons|button, talks to a vendor NPC, or whatever fits your game design.

			
				Expected Output
			
				Expand
				
			local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local productID = 0000000  -- Change this to your developer product ID

-- Function to prompt purchase of the developer product
local function promptPurchase()
	local player = Players.LocalPlayer
	MarketplaceService:PromptProductPurchase(player, productID)
end
		
				Copy Code
			
				Light Theme

After a purchase is made, it’s your responsibility to handle and record the transaction. This can be done through a Script within ServerScriptService using the MarketplaceService/ProcessReceipt|ProcessReceipt callback. The function you define will be called repetitively until it returns Enum.ProductPurchaseDecision.PurchaseGranted.

			
			
				ProcessReceipt Callback
			
			
			
				Expected Output
			
			
				Expand
				
			
		

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

-- Data store for tracking purchases that were successfully processed
local purchaseHistoryStore = DataStoreService:GetDataStore("PurchaseHistory")

-- Table setup containing product IDs and functions for handling purchases
local productFunctions = {}
-- ProductId 123123 for a full heal
productFunctions[123123] = function(receipt, player)
	-- Logic/code for player buying a full heal (may vary)
	if player.Character and player.Character:FindFirstChild("Humanoid") then
		-- Heal the player to full health
		player.Character.Humanoid.Health = player.Character.Humanoid.MaxHealth
		-- Indicate a successful purchase
		return true
	end
end
-- ProductId 456456 for 100 gold
productFunctions[456456] = function(receipt, player)
	-- Logic/code for player buying 100 gold (may vary)
	local stats = player:FindFirstChild("leaderstats")
	local gold = stats and stats:FindFirstChild("Gold")
	if gold then
		gold.Value = gold.Value + 100
		-- Indicate a successful purchase
		return true
	end
end

-- The core 'ProcessReceipt' callback function
local function processReceipt(receiptInfo)

	-- Determine if the product was already granted by checking the data store  
	local playerProductKey = receiptInfo.PlayerId .. "_" .. receiptInfo.PurchaseId
	local purchased = false
	local success, errorMessage = pcall(function()
		purchased = purchaseHistoryStore:GetAsync(playerProductKey)
	end)
	-- If purchase was recorded, the product was already granted
	if success and purchased then
		return Enum.ProductPurchaseDecision.PurchaseGranted
	elseif not success then
		error("Data store error:" .. errorMessage)
	end

	-- Find the player who made the purchase in the server
	local player = Players:GetPlayerByUserId(receiptInfo.PlayerId)
	if not player then
		-- The player probably left the game
		-- If they come back, the callback will be called again
		return Enum.ProductPurchaseDecision.NotProcessedYet
	end
	
	-- Look up handler function from 'productFunctions' table above
	local handler = productFunctions[receiptInfo.ProductId]

	-- Call the handler function and catch any errors
	local success, result = pcall(handler, receiptInfo, player)
	if not success or not result then
		warn("Error occurred while processing a product purchase")
		print("\nProductId:", receiptInfo.ProductId)
		print("\nPlayer:", player)
		return Enum.ProductPurchaseDecision.NotProcessedYet
	end

	-- Record transaction in data store so it isn't granted again
	local success, errorMessage = pcall(function()
		purchaseHistoryStore:SetAsync(playerProductKey, true)
	end)
	if not success then
		error("Cannot save purchase data: " .. errorMessage)
	end

	-- IMPORTANT: Tell Roblox that the game successfully handled the purchase
	return Enum.ProductPurchaseDecision.PurchaseGranted
end

-- Set the callback; this can only be done once by one script on the server! 
MarketplaceService.ProcessReceipt = processReceipt
		

			
		

			
				
				Copy Code
			
			
				Light Theme
				
					
					
				
			
		

Roblox itself does not record the purchase history of developer products by specific players, although you can view overall daily/monthly stats as outlined articles/Developer Stats|here. If you want to track player-specific purchase history, it's your responsibility to store the data, typically with Articles/Data store|data stores. See the MarketplaceService/ProcessReceipt|ProcessReceipt reference for a code example which includes data store usage.

The receiptInfo table passed to the processReceipt() callback function contains detailed info on the purchase. See the MarketplaceService/ProcessReceipt|ProcessReceipt reference for a list of keys and descriptions.

Tags:

product
purchase

Developer Products – In‑Game Purchases

Developer Products – In‑Game Purchases

Creating a Developer Product

Scripting for Developer Products

Getting a Game’s Developer Products

Getting Product Info

Prompting a Purchase

Related Articles

Badges – Special Game Awards

Game Passes – One‑Time Purchases