Set up catalog manually

Set up virtual currencies, virtual items in your Publisher Account following the step-by-step instructions:

Create virtual currency

Virtual currency is virtual money that is used for purchasing and selling in-game items. Depending on its purpose, a virtual currency affects the game economy balance or is connected to the monetization of the app. You can also create hard currency — a virtual currency that is linked to the platform of purchase and can be purchased only for real money.

You can sell the virtual currency in predefined amounts. For a package, you can define a special price that doesn’t equal the amount of virtual currency in it.

See the Virtual currency section to learn more about virtual currency.

To set up virtual currency:

  1. Open your project in Publisher Account and go to Store > Virtual Currency section.
  2. Click New virtual currency.
  3. Specify:
    • Image (optional).
    • SKU.
    • Name.
    • Price in real or virtual currency.
    • Default currency.
    • Attributes (optional).

Note
The price must be set in at least one currency — either real or virtual. The amount of virtual currency can only be specified as a whole number. Detailed information on setting up regional prices in real currency is provided in the documentation.
  1. You can define virtual currency as premium currency. This currency is tied to the platform where the purchase is made and can only be sold for real money. To set up separate storage of premium currency for different platforms, switch the Premium Currency toggle to On.
Note
Currency can be defined as premium currency only at the time of its creation.
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Hide

Set up a virtual currency package

Note
Before creating a virtual currency package, you must first create the currency that will be included in it.

To set up a virtual currency package:

  1. Open your project in Publisher Account and go to Store > Virtual Currency > Packages section.
  2. Click New Package.

  1. Specify:
    • Image of the package (optional).
    • Package SKU.
    • Name for the package.
    • Short description of the package.
    • Virtual currency for a package.
    • Prices in real and virtual currencies.
    • Default currency.
    • Attribute (optional).
Note
You can add only one type of virtual currency to a package. You should specify the prices for virtual currency packages at least in one real or virtual currency. The amount of virtual currency can be specified only as the integer value. Detailed information on setting up regional prices in real currency is provided in the documentation.
  1. To limit the number of times a user can buy a virtual currency package, switch the Limit number of times one user can buy a virtual currency package toggle to On and specify the limit.
  2. To set a time limit for the package to be displayed in the store, in the Show item in store field, select Time period and specify the time zone, the beginning, and the end of the period. To not indicate the end of the item display period, check the No end date box.
  3. Check the settings and click Create package.
Note
After creating a virtual item, virtual currency, or virtual currency package, you can set statuses for the item to determine whether it is available, unavailable, or partially available.
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Hide

Create virtual items

Virtual items are the in-game content that you can sell for real and virtual currency.

There are 3 types of virtual items:

  • Consumable — items that you can have in large quantities and purchase several times. Their quantity is decreased when users consume them.
  • Nonconsumable — items that can be accrued or purchased only once. They keep into user’s inventory and can’t be removed from the inventory by being consumed on the client side. You can withdraw it only via a server method.
  • Time-limited item — a nonconsumable item that is available for a limited period of time and doesn’t disappear from the inventory when it expires. The user needs to buy this item again to activate it.

See the Virtual items section to learn more about virtual items.

To set up virtual items, you need to configure virtual items groups. Groups let you have a multilevel catalog and manage a display of items in the store.

To create groups of virtual items:

  1. Open your project in Publisher Account and go to Store > Virtual Items section.
  2. Click + and select Create group from the drop-down list.

  1. Specify the following parameters:
    • Group code.
    • Group name.
  2. If you want to show the group in a catalog, set the Show group in Store toggle to On.

Note
If the Show group in Store toggle is Off, you can’t use this group in Site Builder.

  1. Click Create group.

To set up a virtual item:

  1. Open your project in Publisher Account and go to Store > Virtual Items section.
  2. Click + and select Create Item from the drop-down list.

  1. Specify:
    • Image (optional).
    • SKU.
    • One or several groups the item should belong to.
    • Name.
    • Description (optional).
Note
An item description is limited to 255 characters. If you need to add a description longer than 255 characters, contact your Customer Success Manager or email to csm@xsolla.com.
    • Item property: consumable, nonconsumable, or time-limited items.
    • Prices in real or virtual currencies.
Notice
You can’t create an item without specifying its price in real or virtual currency. You can’t create an item with a zero price value. Detailed information on setting prices in real currency is provided in the documentation.
  1. Set a purchase limit for the item (optional). To do this, set the Limit number of times one user can buy this item toggle to On and specify the number of items a user can purchase.
  2. To set a time limit for the item to be displayed in the store, in the Show item in store field, select Time period and specify the time zone, the beginning, and the end of the period. To not indicate the end of the item display period, check the No end date box.
  3. Check the settings and click Create item.
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Hide

Create bundles

Bundle is a set of several items that are sold as a single unit. You can add items of different types to a bundle:

  • Virtual currency.
  • Package of virtual currency.
  • Virtual items including time-limited items.
  • Bundles.

See the Bundles section to learn more about bundles.

To set up a bundle:

  1. Open your project in Publisher Account and go to Store > Bundles section.
  2. Click + and select Create bundle from the drop-down list.

  1. Specify:
    • Image (optional).
    • SKU.
    • Name.
    • Description (optional).
    • Contents.
  2. Set the bundle price:
    1. Define the prices or create a free bundle:
      1. To create a free bundle, in the Paid or Free field, select Free bundle.
      2. To set a price, in the Paid or Free field, select Paid bundle and specify the price in real or virtual currencies. If needed, configure regional prices.
Notice
You can’t add the same bundle or physical goods to a bundle. You can’t create an empty bundle.
Note
You can create a bundle without specifying its price in real or virtual currency. If such a bundle is displayed in the store, it will be available to users for free. Detailed information on setting prices in real currency, including regional prices, is provided in the documentation.
  1. Set a purchase limit for the bundle (optional). To do this, turn on the Limit number of times one user can buy bundle toggle to On and specify the number of bundles a user can purchase.
  2. Click Next.
  3. Configure the display of the bundle in the store:
    • Change the status to Available.
    • Set a time limit for displaying a bundle in the store (optional). To do this, select Time period and specify the time zone, the beginning and the end of the period. If you don’t want to indicate the end of the item display period, check the No end date box.
  4. Click Next.
  5. Check the settings and click Save.
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Hide

Next steps

  1. Implement granting of purchases to the user.
  2. Implement getting subscription information.
Last updated: April 2, 2025

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at doc_feedback@xsolla.com.