Sets all the items in one virtual store

Request Details

This operation is not additive. Using it will cause the indicated virtual store to be created from scratch. If there is an existing store with the same storeId, it will be deleted and replaced with only the items specified in this call. A store contains an array of references to items defined inthe catalog, along with the prices for the item, in both real world and virtual currencies. These prices act as an override to any prices defined in the catalog. In this way, the base definitions of the items may be defined in the catalog, with all associated properties, while the pricing can be set for each store, as needed. This allows for subsets of goods to be defined for different purposes (in order to simplify showing some, but not all catalog items to users, based upon different characteristics), along with unique prices. Note that all prices defined in the catalog and store definitions for the item are considered valid, and that a compromised client can be made to send a request for an item based upon any of these definitions. If no price is specified in the store for an item, the price set in the catalog should be displayed to the user.

Request Properties
CatalogVersion String

Catalog version of the store to update. If null, uses the default catalog.

MarketingData StoreMarketingModel

Additional data about the store

Store List<StoreItem>

Array of store items - references to catalog items, with specific pricing - to be added

StoreId (required) String

Unique identifier for the store which is to be updated

POST https://{{TitleID}}
    Content-Type: application/json
    X-SecretKey: <developer_secret_key>
  "StoreId": "BonusStore",
  "Store": [
      "ItemId": "shield_level_5",
      "VirtualCurrencyPrices": {
        "RM": 180,
        "GV": 20
      "RealCurrencyPrices": {
        "GBP": 100
      "ItemId": "energy_boost_1",
      "VirtualCurrencyPrices": {
        "RM": 250,
        "GV": 30
      "ItemId": "starterpack_1",
      "VirtualCurrencyPrices": {
        "RM": 399

Response Details

Result Properties

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8



Possible Error Codes

Name Code
CatalogNotConfigured 1218
InvalidItemId 1093
InvalidJSONContent 1200