Create virtual currency packages in the Publisher Account

Virtual currency is virtual money used to purchase virtual items.

Example currencies: coins, crystals, spheres.

You can create virtual currency packages with a predefined amount of currency. Users can purchase virtual currency packages for real money through the Metaframe widget interface. You can also top up a user’s balance with virtual currency using API methods.

Limitations:

  • Only one type of virtual currency can be added to a package.
  • The amount of virtual currency can be specified only as the integer value.

Note

Any virtual currency you create in the Publisher Account is divided into 6 parts called shards. Shards are divided into points: 1 shard equals 40 points.

One unit of virtual currency is equal to 6 shards or 240 points.

Shards are not available for user purchase and are used for debiting or crediting using API methods. Shards make it possible to credit or debit non-whole values.

Points are not available for user purchase and are not used in API method parameters. Points are used for the proper division of virtual currency into shards.

In the Wallet section, the balance is displayed as both whole a number and a circular grahp showing the progress in shards towards the next whole number.

Notice
To sell virtual currency via the Metaframe widget, create a separate project in the Publisher Account. Do not sell virtual currency or currency packages created in this project via the In-Game Store or Site Builder.

Set up virtual currency

  1. Open your project in the Publisher Account.
  2. In the side menu, click Store.
  3. In the Virtual Currency panel, click:
    • Connect – if you don’t have virtual currency yet
    • Configure – if you have previously connected virtual currency
  4. On the Prices tab, click New virtual currency.
  5. Specify the necessary parameters:
    1. Upload an image of the virtual currency. To ensure virtual currencies and virtual currency packages are displayed optimally in the Metaframe widget, we recommend that you use a 128 x 128 px image on a transparent background.
    2. Specify the SKU of the virtual currency.
    3. Set the name for the virtual currency.
    4. Specify prices in the desired real currencies.
    5. Define the default currency.
  6. Check the settings and click Create currency.

Set up virtual currency package

  1. Open your project in the Publisher Account.
  2. In the side menu, click Store.
  3. In the Virtual Currency panel, click:
    • Connect – if you don’t have virtual currency yet
    • Configure – if you have previously connected virtual currency
  4. On the Packages tab, click New package.
  5. Specify the necessary parameters:
    • Upload an image of the virtual currency package. Upload an image of the virtual currency. To ensure virtual currencies and virtual currency packages are displayed optimally in the Metaframe widget, we recommend that you use a 128 x 128 px image on a transparent background.
    • Specify the package SKU.
    • Set the name of the package.
    • Add a short description of the package.
    • Specify the virtual currency and its quantity within the package. To properly divide virtual currency into shards, multiply it by 240 to indicate the quantity. For example: if you want to sell 5 crystals, enter 1200 in this field (5*240 = 1200).
    • Set prices in real currencies.
    • Define the default currency.
  6. 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.
Note
To ensure proper functioning of the widget, the following parameters are not required to be specified when creating virtual currency and currency package:
  • hard currency
  • price in virtual currency
  • purchase limits for users
  • attributes
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.
Last updated: October 10, 2024

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!