Set up catalog and subscription plans

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.

2. Click Create manually and select Virtual currency from the drop-down list.

3. In the General settings section, specify the following:
   1. SKU
   2. One or several groups the item should belong to (optional)
   3. Name
   4. Short description
   5. Extended description — to add it, turn on the corresponding toggle (optional)

4. In the Media section, upload one or more images or videos (optional) — from your device or via a link. In the store created with the Xsolla site editor, all item cards display the file marked as Main, while the remaining files are available only in item cards with a media gallery. The file marked as Main is also returned in the responses of the catalog retrieval API calls.

5. In the Price settings section, set prices or create a free item:
   • To set a price, select Paid item, turn on the Pricing in real currency toggle, and specify the price. If needed, configure regional prices.
   • To create a free item, select Free item.

6. To limit the number of items available for purchase:
   1. Turn on the toggle in the Limits section and specify the quantity.
   2. Configure the limit reset frequency. To do this, select a period from the drop-down list:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. The interval is calculated from the item’s display start date in the store.
      • No regular refresh.
   3. Set up the reset schedule by specifying the parameters that correspond to the selected period.

7. To configure a display time limit for the item (optional):

   1. Turn on the toggle in the Add specific display period section.
   2. Specify the time zone and the beginning and the end of the period.

   To leave the end of the item’s display period unspecified, turn on the No end date toggle.

8. Configure attributes using one of the following options (optional):
   1. Add attributes and their values in JSON format.
   2. Manually create attributes and their values, and link them to items.

9. If the paid item will be used in any mechanics with a random reward (e.g., loot boxes or gacha), enable the Mark as paid randomized reward toggle.

10. Click Create.

11. In the window that opens, select the item status and click Continue.

The created item will appear in the All items section.

2. Click Create manually and select Virtual currency from the drop-down list.

3. In the General settings section, specify the following:
   1. SKU
   2. One or several groups the item should belong to (optional)
   3. Name
   4. Short description
   5. Extended description — to add it, turn on the corresponding toggle (optional)

4. In the Media section, upload one or more images or videos (optional) — from your device or via a link. In the store created with the Xsolla site editor, all item cards display the file marked as Main, while the remaining files are available only in item cards with a media gallery. The file marked as Main is also returned in the responses of the catalog retrieval API calls.

5. Specify the virtual currency included in the package and its amount.

6. In the Price settings section, set prices or create a free item:

   • To set a price, select Paid item, turn on the Pricing in real currency and/or Pricing in virtual currency toggle, and specify the price. If needed, configure regional prices.
   • To create a free item, select Free item.

7. To limit the number of items available for purchase:
   1. Turn on the toggle in the Limits section and specify the quantity.
   2. Configure the limit reset frequency. To do this, select a period from the drop-down list:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. The interval is calculated from the item’s display start date in the store.
      • No regular refresh.
   3. Set up the reset schedule by specifying the parameters that correspond to the selected period.

8. To configure a display time limit for the item (optional):

   1. Turn on the toggle in the Add specific display period section.
   2. Specify the time zone and the beginning and the end of the period.

   To leave the end of the item’s display period unspecified, turn on the No end date toggle.

9. Configure attributes using one of the following options (optional):
   1. Add attributes and their values in JSON format.
   2. Manually create attributes and their values, and link them to items.

10. If the paid item will be used in any mechanics with a random reward (e.g., loot boxes or gacha), enable the Mark as paid randomized reward toggle.

11. Click Create.

12. In the window that opens, select the item status and click Continue.

The created item will appear in the All items section.

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.

2. Click Create manually and select Virtual item from the drop-down list.

3. In the General settings section, specify the following:
   • SKU
   • One or several groups the item should belong to (optional)
   • Name
   • Short description
   • Extended description — to add it, turn on the corresponding toggle (optional)

4. In the Media section, upload one or more images or videos (optional) — from your device or via a link. In the store created with the Xsolla site editor, all item cards display the file marked as Main, while the remaining files are available only in item cards with a media gallery. The file marked as Main is also returned in the responses of the catalog retrieval API calls.

5. In the Price settings section, set prices or create a free item:
   • To set a price, select Paid item, turn on the Pricing in real currency and/or Pricing in virtual currency toggle, and specify the price. If needed, configure regional prices.
   • To create a free item, select Free item.

6. To limit the number of items available for purchase:
   1. Turn on the toggle in the Limits section and specify the quantity.
   2. Configure the limit reset frequency. To do this, select a period from the drop-down list:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. The interval is calculated from the item’s display start date in the store.
      • No regular refresh.
   3. Set up the reset schedule by specifying the parameters that correspond to the selected period.

7. To configure a display time limit for the item (optional):

   1. Turn on the toggle in the Add specific display period section.
   2. Specify the time zone and the beginning and the end of the period.

   To leave the end of the item’s display period unspecified, turn on the No end date toggle.

8. Configure attributes using one of the following options (optional):
   1. Add attributes and their values in JSON format.
   2. Manually create attributes and their values, and link them to items.

9. If the paid item will be used in any mechanics with a random reward (e.g., loot boxes or gacha), enable the Mark as paid randomized reward toggle.

10. Click Create.

11. In the window that opens, select the item status and click Continue.

The created item will appear in the All items section.

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:

2. Click Create manually and select Bundle from the drop-down list.

3. In the General settings section, specify the following:
   • SKU
   • One or several groups the item should belong to (optional)
   • Name
   • Short description
   • Extended description — to add it, turn on the corresponding toggle (optional)

4. In the Media section, upload one or more images or videos (optional) — from your device or via a link. In the store created with the Xsolla site editor, all item cards display the file marked as Main, while the remaining files are available only in item cards with a media gallery. The file marked as Main is also returned in the responses of the catalog retrieval API calls.

5. In the Bundle items section, select SKUs to add to the bundle. At least one item is required.

6. In the Price settings section, set prices or create a free item:
   • To set a price, select Paid item, turn on the Pricing in real currency and/or Pricing in virtual currency toggle, and specify the price. If needed, configure regional prices.
   • To create a free item, select Free item.

7. To limit the number of items available for purchase:
   1. Turn on the toggle in the Limits section and specify the quantity.
   2. Configure the limit reset frequency. To do this, select a period from the drop-down list:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. The interval is calculated from the item’s display start date in the store.
      • No regular refresh.
   3. Set up the reset schedule by specifying the parameters that correspond to the selected period.

8. To configure a display time limit for the item (optional):

   1. Turn on the toggle in the Add specific display period section.
   2. Specify the time zone and the beginning and the end of the period.

   To leave the end of the item’s display period unspecified, turn on the No end date toggle.

9. Configure attributes using one of the following options (optional):
   1. Add attributes and their values in JSON format.
   2. Manually create attributes and their values, and link them to items.

10. If the paid item will be used in any mechanics with a random reward (e.g., loot boxes or gacha), enable the Mark as paid randomized reward toggle.

11. Click Create.

12. In the window that opens, select the item status and click Continue.

The created item will appear in the All items section.

3. Choose and set up the plan type:
   • Regular plan with regular payments.
   • Lifetime plan with a one-time payment and an unlimited period of validity.
   • Season pass with a one-time payment and a limited period of validity.

Set up regular plan

1. Specify:
   1. Plan name.
   2. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

2. Click Next.
3. Choose one of the subscription fee options:
   • Regular: the amount of each payment is specified manually.
   • Including setup fee: the amount of each payment as well as the amount of the setup fee are specified manually. Use this setting if you want to charge the subscriber for cover additional costs such as connecting a license, setting up a system, training a user, or providing a consultation The first payment in this case will include a setup fee, the remaining payments will be equal to the amount of the regular payment.

• • Associated with the first payment: the amount of each payment is equal to the first payment. The subscription cost and currency type are passed in the purchase.checkout.amount and purchase.checkout.currency parameters when opening the payment UI. Use this option if you want to manage pricing on your side and set individual prices for specific users.

4. Whether you choose a regular subscription fee or with setup fee, you can set up different subscription prices for different currencies. To do this:

• 1. In the Currency and Price field, select the required currency and specify the value of the subscription price. For a subscription with setup fee, also enter the value of the setup fee in the corresponding field.

• 2. Click + to add prices in other currencies.

• 3. Specify the default currency.

5. Configure the billing cycle:
   1. Specify the frequency of the payment.
   2. Specify the number of days in the trial period where the subscription can be used without a payment. Set the value to 0 to create a plan that does not have a trial period.

6. Specify parameters for a one-time payment. With this type of subscription renewal, users make payments via a payment link sent by email.
   1. Expiration reminder: Specify the number of days before the subscription expiration date when the user will receive a reminder. If the value is set to 6 or higher, the user receives an extra reminder one day before the expiration date. Set the value to 0 if you don’t want to send any reminders.
   2. Grace period: The number of days users can continue using their subscription after its expiration date, and have the option to renew it. Set the value to 0 to create a plan that does not have a grace period.

7. Specify the parameters for an automatic payment: with this type of subscription renewal, payments are made automatically using the saved billing information without any user interaction.
   1. Subscription expiration reminder.
   2. The number of retries after the first unsuccessful attempt to charge for the subscription. The system will retry once a day.

8. Click Next.

9. Click Create.

Set up lifetime plan

1. Specify:
   1. Plan name.
   2. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

2. Click Next.
3. Choose one of the subscription fee options:
   • Regular: the amount of each payment is specified manually.
   • Associated with the first payment: the amount of each payment is equal to the first payment made by the user. The subscription cost and currency type are passed in the purchase.checkout.amount and purchase.checkout.currency parameters when opening the payment UI. Use this option if you want to manage pricing on your side and be able to set the individual price for a specific user.

4. In the Refund period field, set the number of days when the user can unsubscribe and refund the payment.

5. Whether you choose a regular subscription fee, you can set up different subscription prices for different currencies. To do this:

• 1. In the Currency and Price field, select the required currency and specify the value of the subscription price.

• 2. Click + to add prices in other currencies.

• 3. Specify the default currency.

6. Click Next.

7. Click Create.

Set up season pass

1. Specify:
   1. Plan name.
   2. Season pass validity period.
   3. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

2. Click Next.
3. Choose one of the subscription fee options:
   • Regular: the amount of each payment is specified manually.
   • Associated with the first payment: the amount of each payment is equal to the first payment made by the user. The subscription cost and currency type are passed in the purchase.checkout.amount and purchase.checkout.currency parameters when opening the payment UI. Use this option if you want to manage pricing on your side and be able to set the individual price for a specific user.

4. In the Refund period field, set the number of days when the user can unsubscribe and refund the payment.

5. Whether you choose a regular subscription fee, you can set up different subscription prices for different currencies. To do this:

• 1. In the Currency and Price field, select the required currency and specify the value of the subscription price.

• 2. Click + to add prices in other currencies.

• 3. Specify the default currency.

6. Click Next.

7. Click Create.