> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Stores (Economy Legacy) Quickstart
> Quickstart for creating PlayFab Legacy Economy (v1) stores, adding items, setting store-specific prices, and displaying stores to players in-game.
# Stores Quickstart (Legacy Economy)
Economy v1 APIs are in maintenance mode and will not be receiving any new features, only bug fixes. **The v1 APIs will be maintained for the foreseeable future.** See the [Economy v2 Overview](/services/playfab/economy-monetization/economy-v2/overview) to learn more about the next version of PlayFab Economy!
Stores are the best way to let players purchase items in your game.
As shown in the [Items quickstart](/services/playfab/economy-monetization/economy/items/quickstart), PlayFab supports buying items out of a catalog, but that's not how most games structure their purchases. Whether you're making an idle clicker, an RPG, an FPS, or an endless runner, you probably have vendors in your game. Places where players can buy weapons, armor, or running shoes.
Our solution for in-game vendors and shops is Stores, a subset of your catalog with prices you can override.
In this stores quickstart, you will:
* Add items to a catalog with regular prices.
* Create a store that contains the same items with discounted prices.
* Use PlayFab APIs to purchase an item from the store.
* Use information in the Game Manager to confirm that the item was purchased at the discounted store price.
## Adding items to a catalog
First, let's add some Items to sell in your catalog:
1. Open **Game Manager** and select **Economy** on the left side bar.
2. Select the **Catalogs** tab, and open your **main** catalog.
3. Select **New Item** a few times, and create some items:
* **apricot** with a **GD** price of **4**.
* **pear** with a **GD** price of **3**.
* **grape** with no **GD** price (don't select any prices).
You don't have to assign a virtual currency price to items in a catalog for them to appear in a store.
In the following example, an item called **apricot** is added to the **main** catalog with a **GD** price of **4**.
## Creating a store
You should now have a few items with prices in your catalog. Let's create a store to sell them to a player.
1. Open your **main** catalog and select **Stores**.
2. Select **New store**.
3. Set the **Store Id** and **Store name** to **fruits** (as shown in the following example).
4. Select **ADD TO STORE**.
* A pop-up screen - like the one shown below - will display all the items, bundles, and containers in the current catalog.
5. Add a few items to your store by selecting the **Add** button next to the item.
## Setting the store price for an item
You should now see your items listed in the **STORE CONTENTS**, but they're not valid until they have at least one price.
The little static number (for example, **\< 4**) next to the price text box is the original catalog price. You only have to enter a price for *one* box in each row, but you can enter as many prices as you want.
* If you don't enter any price for an item, it will be removed from the store.
* If a store item doesn't have a price in a currency, it can't be bought using that currency.
* Store prices can be higher than catalog prices, and zero is a valid price for an item.
You can drag-and-drop the rows in the store contents to rearrange the order of the items.
1. Add some **GD** prices to your items, but make them lower than the catalog prices:
* **Apricot: 3**.
* **Pear: 2**.
* **Grape: 1**.
2. Select **SAVE STORE** when you're done.
In the following example, an item called **apricot** with a catalog price of **4 GD** is given a store price of **3 GD**.
## Purchasing an item from the store
Now that you have a store, let's use the PlayFab APIs to buy an item from the store in your game.
1. Get your store by calling [GetStoreItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems) with these parameters in the request:
* `CatalogVersion = "main"`
* `StoreId = "fruits"`
2. The `Store` field in [GetStoreItemsResult](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems#getstoreitemsresult) should contain a list of your store items and their prices.
3. Call [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) with values in the request that specify the currency and store price of the item you want to buy.
* `CatalogVersion = "main"`
* `StoreId = "fruits"`
* `ItemId = "pear"`
* `VirtualCurrency = "GD"`
* `Price = 2`
If you don't specify the **`StoreId`** when calling [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem), the purchase is attempted against the catalog price.
## Confirming the purchase price
Open Game Manager, and confirm that the purchase was made at the store price of two GD.
1. Select **Players** from the left side bar to open the **Players** tab.
2. Select the **ID** of the player that purchased the item.
3. Check the following information for the player:
* Open the **Inventory** tab. The inventory should now contain a **pear**.
* Open the **Virtual Currency** tab. Check the virtual currency **Amount** to verify that the player only spent 2 GD.
* Open the **PlayStream** tab. You'll see events showing the purchase flow from the store. Events include a [Player virtual currency item purchased](/services/playfab/api-references/events/Player/player-vc-item-purchased) event, and a [Player virtual currency balance changed](/services/playfab/api-references/events/Player/player-virtual-currency-balance-changed) event showing that the virtual currency balance changed by two GD.
You can use the Game Manager to change the order of items in your store and adjust prices at any time.
## Next steps
Now that you've learned how to create and utilize stores in your game, you're ready to explore some more advanced uses of stores.
For example, by using segments with stores, you can give special prices to certain players without touching your game code.
* [Custom stores for player segments](/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments)
* [Best practices for store segmentation](/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation)
## Related topics
- [Economy (Legacy) quickstart](/services/playfab/economy-monetization/economy/quickstart.md)
- [Items (Legacy Economy) quickstart](/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Stores and sales in Economy (Legacy)](/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Custom Stores for Player Segments in Economy (Legacy)](/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Stores (Legacy Economy)](/services/playfab/economy-monetization/economy/stores/index.md)