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 via Publisher Account:

1. In your project in Publisher Account, go to the Items catalog > All items section.
2. Click Add and select Virtual currency from the drop-down list.

3. Specify the following parameters:
   1. Image (optional).
   2. SKU.
   3. Virtual currency name.
4. To configure how virtual currency is displayed in the store, select the appropriate status.

5. To set a price, click Set up prices and specify the price in real currency. If needed, configure regional prices.
6. Configure attributes using one of the following methods (optional):

1. 1. Add attributes and their values in JSON format.

1. 2. Manually create attributes and values and link them to specific items.

7. Check the settings and click Create currency.

1. In your project in Publisher Account, go to the Items catalog > All items section.
2. Click Add and select Virtual currency package from the drop-down list.

3. Specify the following parameters:
   1. Image (optional).
   2. SKU.
   3. One or several groups the package should belong to.
   4. Name.
   5. Description (optional).
4. To configure how virtual currency is displayed in the store, select the appropriate status.

5. Specify the virtual currency included in the package and its amount.
6. Set prices or create a free item in the Paid or free field:

1. • To create a free package, select Free package.

1. • To set a price, select Paid package and specify the price in real currency. If needed, configure regional prices.

7. To limit the number of packages available for purchase, turn on the Limit number of times one user can buy package toggle and enter the desired quantity.
8. To configure how often the limit resets:

1. 1. From the drop-down list, select a period:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval – this is calculated starting from the package’s display start date.
      • No regular refresh.

1. 2. Set up the reset schedule based on the selected period.

9. Configure a time limit for displaying a package (optional):

1. 1. In the Show item in store field, select Limited time.

1. 2. Specify the time zone and the beginning and the end of the period.

1. 1. If you don’t want to indicate the end of the item display period, check the No end date box.

10. Configure attributes using one of the following methods (optional):

1. 1. Add attributes and their values in JSON format.

1. 2. Manually create attributes and values and link them to specific items.

11. Check the settings and click Create package.

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

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

1. In your project in Publisher Account, go to the Items catalog > All items section.
2. Click Add and select Virtual item from the drop-down list.

3. Specify the following parameters:
   • Image (optional).
   • SKU.
   • One or several groups the item should belong to.
   • Name.
   • Description (optional).
4. To configure how the virtual item is displayed in the store, select the appropriate status.

5. Set prices or create a free item in the Paid or free field:

1. • To create a free item, select Free item.

1. • To set a price, select Paid item and specify the price in real currency. If needed, configure regional prices.

6. To limit the number of items available for purchase, turn on the Limit number of times one user can buy this item toggle and enter the desired quantity.
7. To configure how often the limit resets:

1. 1. From the drop-down list, select a period:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval – this is calculated starting from the item’s display start date.
      • No regular refresh.

1. 2. Set up the reset schedule based on the selected period.

8. Configure a time limit for displaying the item (optional):

1. 1. In the Show item in store field, select Limited time.

1. 2. Specify the time zone and the beginning and the end of the period.

1. 1. If you don’t want to indicate the end of the item display period, check the No end date box.

9. Configure attributes using one of the following methods (optional):

1. 1. Add attributes and their values in JSON format.

1. 2. Manually create attributes and values and link them to specific items.

10. Check the settings and click Create item.

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 create a bundle:

1. In your project in Publisher Account, go to the Items catalog > All items section.
2. Click Add and select Bundle from the drop-down list.

3. Specify the following parameters:
   • Image (optional).
   • SKU.
   • One or several groups the bundle should belong to.
   • Name.
   • Description (optional).
4. Configure bundle attributes (optional) using one of the following methods:
   • Add attributes and their values in JSON format.
   • Manually create attributes and values, and link them to specific items.
5. Click Next.
6. If partner-side personalization is enabled, you can choose between a standard and a dynamic bundle type. Dynamic bundles allow you to skip item creation in Xsolla and instead return bundle contents generated by your server when the catalog is requested. If partner-side personalization is disabled, the bundle type selector is not displayed, and a standard bundle is created automatically.

7. Add items to the bundle:
   1. Select the item type.
   2. Specify one or more item SKUs to be included in the bundle.
   3. Set the quantity for each SKU.

8. Click Next.
9. Set the bundle price in the Paid or Free field:
   • To create a free bundle, select Free bundle.
   • To set a price, select Paid bundle and specify the price in real or virtual currency. You can’t create a bundle with a price of zero. If needed, configure regional prices.
10. To limit the number of bundles available for purchase, turn on the Limit bundle purchases per user toggle and enter the desired quantity.

11. To configure how often the limit resets:
    1. From the drop-down list, select a period:
       • Daily.
       • Weekly.
       • Monthly.
       • Custom interval — this is calculated starting from the bundle’s display start date.
       • No regular refresh.
    2. Set up the reset schedule based on the selected period.

12. Click Next.

13. Configure how the bundle is displayed in the store:
    1. Choose the status.
    2. Set a display time limit for the bundle (optional): specify the time zone and 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.

14. Click Next.
15. Check the settings and click Save.

1. Open your project in Publisher Account and go to the Items catalog > All items section.
2. Click Add and select Game key from the drop-down list.
3. Set the basic package settings:
   1. Add general information for each game, including:
      • Image (optional)
      • SKU
      • Game title
      • Game description (optional)
   2. Add a link to the game page (optional):
      1. Set the Add game page link toggle to On.
      2. If the game does not have a page, select Create new game page and specify Game page name.

4. Click Save and continue.
5. Select the game distribution platforms and upload a CSV or TXT file with keys. Each key’s alphanumeric combination must be unique. Keys with an identical combination will not be uploaded.
6. If you want to sell the game before its official release, set the Pre-orders toggle to On. You can specify the release date when the keys will be delivered to users instantly when creating the keys or later.
7. Click Save and continue.
8. Set up pricing for the selected platforms. Define prices or create free keys:
   • To create a free key package, in the Paid or free field, select Free game key.
   • To set a price, in the Paid or free field, select Paid game key and specify the price in real or virtual currencies. If needed, configure regional prices.
9. To set a limit for purchasing a game key (optional). To do this, switch the Limit for game key purchase per user toggle to On and specify the number of keys a user can purchase.
10. Click Save and continue.
11. After successfully creating a package of keys, a modal window will appear with game keys selling options. These options include selling keys via Site Builder, via widget, or via direct link. You can select one of the options: go to sales setup immediately or return at any time later.

To make changes to the created game keys package, select the key on the Game keys tab, make changes, and save.