Roblox integration guide
Before you start
- A published Roblox experience that sells developer products. To add one: Creator Hub, your experience, Monetization, Developer Products, Create.
- Access to Roblox Studio and Creator Hub for that experience.
- An R3FTO publisher organization with the game added in the Publisher console.
Game passes, subscriptions, paid access and private servers are not covered.
R3FTO never needs a cookie, an extra Roblox account or group membership.
The SDK runs only on your game server. It reports each developer product receipt and each R3FTO creator link a player arrives with. It never grants a product, never answers Roblox for you, and never changes what your receipt handler decides.
How receipts reach R3FTO
- When Roblox calls your receipt handler, the SDK notes the time it first saw the receipt. That time never changes.
- The SDK saves a copy in your own DataStore (R3FTO_Receipts_v1) and sends the receipt to R3FTO. If one of them fails for a short-lived reason, the SDK tries it again a few times by itself.
- R3FTO counts each PurchaseId once, even if it arrives more than once.
- With your Open Cloud API key, R3FTO also reads the copies in your DataStore, so it still finds a receipt that did not reach R3FTO.
- If the copy and the delivery both fail and the server closes, the receipt is lost. A missing receipt does not mean there was no sale.
- The SDK never deletes its DataStore copies. Each copy holds the buyer's UserId, so your own data deletion duties apply to it.
Creator links and players
You never create links for creators. When a player opens your experience from an R3FTO creator link, the link's reference arrives in the player's launch data. The SDK reads it when the player joins (and for players already in the server when it starts) and reports it with the player's Roblox UserId as seen by your server.
The R3FTO Key panel (optional)
Players can also type a creator's R3FTO Key in your game. Call R3FTO.openKeyPanel(player) from server code, for example when the player presses your own button. The panel's words are fixed and it never sets a key on its own: the player types it. A typed key counts for that creator from the moment R3FTO records it and comes before any creator link. Use the Test token in Studio.