Set up catalog and subscription plans

Set up virtual currencies, virtual items and/or subscription plans 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.
  2. Click Store in the side menu and connect the Virtual Currency module.

  1. On the Prices tab, click New virtual currency.

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

To set up a virtual currency package:

  1. Open your project in Publisher Account.
  2. Click Store in the side menu and go to Virtual Currency.
  3. Go to Packages.
  4. Click New package.

  1. Specify the following parameters:
    • 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.

  1. If you want to display the package in the Store catalog, set the Show in Store toggle to ON.
  2. Click Create package.

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.
  2. Click Store in the side menu and connect the Virtual Items module.

  1. Click Create a group.

  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
Items that don’t have a specified group are added to the Ungrouped group.

  1. Click Create group.

To set up a virtual item:

  1. Open your project in Publisher Account.
  2. Click Store in the side menu and connect the Virtual Items module.
  3. Click Create an item.

  1. Specify:
    • Image.
    • SKU.
    • One or several groups the item should belong to.
    • Name.
    • Description.
    • 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.

  1. If you want to show an item in the store, set the Show item in store toggle to ON.
  2. Click Create an 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 nonrenewing subscriptions.
  • Bundles.

See the Bundles section to learn more about bundles.

To set up a bundle:

  1. Open your project in Publisher Account.
  2. Click Store in the side menu and connect the Bundles module.

  1. Click Create bundle.
  2. Specify the following parameters:
    • Image (optional).
    • SKU.
    • Name.
    • Short description (optional).
    • Product type.
    • Price.

Notice
You can’t add the same bundle or physical goods to a bundle. You can’t create an empty bundle.
Note
The bundle price should be a fixed value of real and/or virtual currency.

  1. If you want to show the bundle in a catalog, set the Show group in Store toggle to ON.
  2. 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

Set up subscription plan

  1. Open your project in Publisher Account.
  2. Go to the Subscriptions section.
  3. On the Subscription plan tab, click Create subscription plan.

  1. Choose and set up a plan type:

Note
All plans created through Publisher Account are assigned an External ID value which allows you to:
  • Open a payment UI with a specific plan.
  • Identify the plan in alerts.
  • Identify the plan in a transactional report.
If you need to manually specify the External ID, create a plan using the Create Plan API endpoint.

Set up regular plan

  1. On the Subscription info step, specify:
    1. Plan name: Select a name for your plan.
    2. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

  1. Click Next.
  2. On the Payment Information step, select a method for defining the cost of your subscription fee:
    1. Set the price associated with the first payment: The amount of each payment is equal to the first payment made by the user.
    2. Set another price: The amount of each payment is set manually. When you select this option, specify the price and currency in the field that appears.

  1. Configure the billing cycle:
    1. Billing cycle: Specify the frequency of payment.
    2. Trial period: 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.

  1. Specify parameters for a one-time payment: this type of subscription renewal is where a user makes a payment via a payment link sent through email.
    1. Expiration reminder: Specify the number of days before a 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 a will be able to continue using their subscription after it has passed its expiration date, and has the option to renew it. Set the value to 0 to create a plan that does not have a grace period.

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

  1. Click Next.
  2. On the Other settings step, enable bonuses for subscribers (optional):
    1. Set the Send bonuses to subscribers toggle to On.
    2. Specify frequency of bonuses.
    3. Add virtual items or virtual currency that you want to send as a bonus.
    4. Add a commentary for a subscriber (optional). The commentary appears in the transaction history in Pay Station.

Note
If the Send bonuses to subscribers toggle is not active, make sure you set up the Virtual currency or Virtual items modules.

Set up lifetime plan

  1. On the Subscription Info step, specify:
    1. Plan name: Select a name for your plan.
    2. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

  1. Click Next.
  2. On the Payment information step, select a method for defining the cost of your subscription:
    1. Set the price associated with the first payment: The amount of each payment is equal to the first payment made by the user.
    2. Set another price: The amount of each payment is set manually. When you select this option, specify the price and currency in the field that appears.
  3. In the Refund period field, set the number of days when the user can unsubscribe and refund the payment.

  1. Click Next.
  2. On the Other settings step, enable bonuses for subscribers (optional):
    1. Set the Send bonuses to subscribers toggle to On.
    2. Specify frequency of bonuses.
    3. Add virtual items or virtual currency that you want to send as a bonus.
    4. Add a commentary for a subscriber (optional). The commentary appears in the transaction history in Pay Station.

Note
If the Send bonuses to subscribers toggle is not active, make sure you set up the Virtual currency or Virtual items modules.

Set up season pass

  1. On the Subscription Info step, specify:
    1. Plan name: Select a name for your plan.
    2. Time period: Season pass validity period.
    3. Description (optional): This plan description is displayed in the payment UI when users are purchasing a subscription.

  1. Click Next.
  2. On the Payment information step, select a method for defining the cost of your subscription:
    1. Set the price associated with the first payment: The amount of each payment is equal to the first user’s payment.
    2. Set another price: The amount of each payment is set manually. When you select this option, specify the price and currency in the field that appears.
  3. In the Refund period field, set the number of days when the user can unsubscribe and refund the payment.

  1. Click Next.
  2. On the Other settings step, enable bonuses for subscribers (optional):
    1. Set the Send bonuses to subscribers toggle to On.
    2. Specify frequency of bonuses.
    3. Add virtual items or virtual currency that you want to send as a bonus.
    4. Add a commentary for a subscriber (optional). The commentary appears in the transaction history in Pay Station.

Note
If the Send bonuses to subscribers toggle is not active, make sure you set up the Virtual currency or Virtual items modules.
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
Your progress
Thank you for your feedback!
Last updated: September 2, 2022

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!