Skip to content

Prompt Purchase

Prompt Purchase asks Roblox to open a Developer Product or GamePass purchase prompt, then routes the story based on the result.

Use Insert > Playback & Flow > Prompt Purchase when a route should offer a Roblox purchase and continue through Purchased, Cancelled, or Already Owned branches.

Properties

Node-specific properties

Field What it does
Purchase Type Developer Product or GamePass.
Product ID Developer Product ID used when Purchase Type is Developer Product.
GamePass ID GamePass ID used when Purchase Type is GamePass.
Purchased For Developer Products, the route used after your server receipt handler reports a granted receipt to VNC. For GamePasses, the route used after a successful prompt.
Cancelled Route used when the prompt is cancelled, cannot open, or is unavailable.
Already Owned GamePass-only route used when the player already owns the selected GamePass.

Inherited/common properties

Field What it does
Name Optional label used in the editor and Story Map. Leave it empty to use VNC's automatic node name.

Runtime Behavior

Installed runtime prompts are server-owned. Preview and contexts without live prompt support follow Cancelled instead of waiting forever.

For GamePass prompts, VNC checks existing ownership before prompting. If the player already owns the GamePass, the node follows Already Owned.

For Developer Products, closing the prompt never selects Purchased. The node remains pending until your experience-owned MarketplaceService.ProcessReceipt callback grants the product and reports that receipt to VNC.

VNC does not replace MarketplaceService.ProcessReceipt. Connect your existing receipt owner through the Developer Product receipt integration.

Purchased, Cancelled, and Already Owned appear as separate branch rows in Story Map and Explorer so inserting into one outcome does not auto-link the other outcomes.

Outputs

OutputWhen it runs
PurchasedA matching Developer Product receipt is reported after the host grants it, or a GamePass prompt succeeds.
CancelledThe prompt is cancelled, fails to open, or prompt support is unavailable.
Already OwnedThe selected GamePass is already owned before the prompt opens.

Prompt Purchase is best for optional routes, upsells, and access checks that should stay readable in Story Map through explicit purchase outcome branches.