> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Showcase API Reference

Product sales feature




Provide in-game store functionality.

Set a price and a reward for the products to be sold. Multiple resources can be set for both compensation and rewards.

A system called "Sales Item Group" is used to implement mechanisms such as step gachas and first-time-only discounts.
Sales Item Group are a mechanism to group together multiple Sales Items by prioritizing each Sales Item, so that the Sales Items that meet the requirements for purchase and have the highest priority are displayed.

On a standard showcase, all of the specified DisplayItems are placed.
There are two types of DisplayItem: "SalesItem" and "SalesItemGroup."

- A SalesItem can be configured with the cost required to purchase it and the reward obtained when purchased.
- A SalesItemGroup is a mechanism in which the SalesItem being sold changes depending on the number of purchases.

On a random showcase, a specified number of DisplayItems are randomly drawn from those specified in master data and placed.

The drawing result is stored per player as `RandomShowcaseStatus`, and stock is consumed at the time of purchase. When the redraw interval is reached, the displayed contents are updated on the next access.

By integrating with GS2-Buff, you can dynamically adjust the `acquireActions`, `verifyActions`, and `consumeActions` of DisplayItem and RandomDisplayItemModel, and for randomly displayed items `stock` can be overwritten as well. Rewards, required costs, and stock counts can be changed flexibly in line with events and campaigns.

[Introduction to Microservices / GS2-Showcase](../../microservices/showcase)



- [GS2-Showcase Buff Reference](/api_reference/showcase/buff/)
  
- [GS2-Showcase Deploy/CDK Reference](/api_reference/showcase/deploy/)
  
- [GS2-Showcase Master Data Reference](/api_reference/showcase/master_data/)
  
- [GS2-Showcase Script Trigger Reference](/api_reference/showcase/script/)
  
- [GS2-Showcase SDK API Reference](/api_reference/showcase/sdk/)
  
- [GS2-Showcase SDK for Game Engine API Reference](/api_reference/showcase/game_engine/)
  
- [GS2-Showcase Transaction Actions](/api_reference/showcase/stamp_sheet/)