In-app purchases

Enable in-app purchases and earn money from paid services (additional time to complete a level, accessories for the game character, etc.).

Advantages:

  • Platform support:

    • Marketing campaigns focus on attracting paying users among both Russian and international audiences.
    • The recommendation system shows games with in-app purchases more often.
    • Games with purchases and good metrics can appear in more blocks and selections on the main page.
  • Financial stability: games with in-app purchases are less affected by seasonality and fluctuations in advertising revenue.

  • Player return rate: users who have made at least one purchase are more likely to return to the game after spending money on its content.

  • Smooth gameplay: purchases fit organically into the gameplay, complementing and enhancing it.

Alert

Before adding purchases, set up unprocessed payment verification.

This check is mandatory for passing moderation, so it's important to set it up even for test purchases. If you add purchases to the game and test them before setting up consumption, then after testing, unprocessed payments may remain, which will make passing moderation impossible.

Portal currency

The portal currency of the Yandex Games platform is used to pay for in-game purchases. It is stored in a single balance for all games, which can be replenished using bank cards. The exchange rate of the portal currency to the ruble is dynamic.

Note

For international payments, the exchange rate of the portal currency to the national currency will depend on the player's country.

You can replenish your balance:

  • in the header of the catalog;
  • in the player's profile;
  • during a purchase in the game.

Users can also receive portal currency as a bonus for participating in promotions or purchasing fixed packs.

Both authorized and unauthorized users on Yandex can make in-game purchases. A user can log in directly during the game, including at the time of making a purchase.

The order and conditions for paying royalties will not change with the introduction of portal currency.

Enable purchases

Step 1. Send a request to connect

  1. Enable monetization. To do this, send an application to join the Yandex Advertising Network and wait for its approval.

    Make sure that in the partner interface of the Yandex Advertising Network you have specified the details for payments for advertising and purchases. If not, click the Add bank details button, fill in the fields, and send the data.

    After checking the data, the contract status in the interface of the Yandex Advertising Network in the section Extras → Documents will change to Offer accepted.

    Alert

    In-game purchases can only be enabled after accepting the offer.

  2. Enable purchases. To do this, send an email with request to enable purchases to games-partners@yandex-team.com. Specify:

    • the name of the game;
    • the identifier (ID) of the game.

    Wait for an email from games-partners@yandex-team.com confirming that purchases are allowed.

Step 2. Update the game source files

  1. Add SDK code to the game source files.

  2. Access the Games Console with your developer account.

  3. In the upper left corner of the console, click Applications.

  4. Find the previously uploaded game in the list and click on it.

  5. Go to the Draft tab.

  6. Edit the fields and upload a new archive. For a detailed description of the fields, see the Upload a game section.

Step 3. Add purchases

Alert

The maximum number of purchases is 500.

  1. Go to the In-app purchasesInaps tab.

  2. Click Add in-app.

  3. Fill in the fields:

    Field

    Description

    Required

    ID

    The identifier of the purchase, which will be passed in the payments.purchase() method.

    Price

    Cost of the purchase for the user in the portal currency. Integer.

    Icon

    Size — 256 × 256 pixels. Format — PNG. Will be displayed in the dialog box when paying for the purchase.

    Title

    The name of the purchase in Russian and English. Will be displayed in the dialog box when paying for the purchase.

    Description

    Description of the purchase in Russian and English. Will be displayed in the dialog box when paying for the purchase. Limit — 200 characters.

  4. Click Add. The table with purchases will be updated.

Note

You can upload a default icon. It will be displayed for in-app purchases that do not have a separate image assigned.

  1. Go to the tab In-app purchasesInaps.

  2. Familiarize yourself with the example by the link Download an example and prepare a file for upload in CSV format.

    Check that the mandatory fields are filled in:

    Field

    Description

    Mandatory

    id

    The purchase identifier that will be passed in the payments.purchase() method.

    price

    The cost of the purchase for the user in portal currency. Integer.

    title_en

    The name of the purchase in English.

    description_en

    Description of the purchase in English. Limit — 200 characters.

    title_ru

    The name of the purchase in Russian.

    description_ru

    Description of the purchase in Russian. Limit — 200 characters.

  3. Click the Upload a CSV file button.

  4. Select purchases for upload on the tabs:

    • Ready for import — purchases with new id. If they are uploaded, new purchases will be created in the system.
    • Matches — purchases whose id are already in the system. If they are uploaded, current purchases will be updated.

    On the Errors tab, you can see which purchases have a problem. To upload them, go back to step 2 and correct the fields in the CSVfile.

    Alert

    You can upload no more than 100 purchases at a time. If the number of in-apps in the file exceeds the maximum allowed value, the first 100 items will be uploaded.

  5. Click Import <N> in-apps. The table with purchases will be updated.

Note

To use your own image for an in-app purchase:

  • Edit it and upload a custom icon.

  • Upload a default icon. It will be displayed for in-app purchases that don't have a separate image set.

Step 4. Publish a new version of the game

Tip

  • Before passing moderation, you can test the game on your own.
  • If you don't want to submit the game for moderation right away, save it as a draft (the status will change to Created), so you can come back to editing the fields later.
  1. Go to the Draft tab.

  2. If you want to choose the moment of publishing the game yourself, select the Postpone publication option. Otherwise, the game will be published immediately after moderation.

  3. Click Submit for moderation.

    Note

    If your game has been under review for more than 100 days ago, you will see a warning that the requirements may have changed. Decline to submit for moderation, review the requirements, and check if the game meets them. After that, resubmit the game for moderation.

    The game will be uploaded to the Yandex server and its status will change to Waiting for moderation.

    Moderators will review your app for compliance with the requirements. Moderation usually takes from three to five working days.

Results of the check you will see in the console:

  • If the game is approved, the draft status will change to Verified, the Publish button will appear on the Draft tab, and the Purchases are enabled status will appear on the In-app purchasesInaps tab.

    On the Draft tab, click Publish. After a couple of minutes, the status will change to Published, and users will be able to find your game in the Yandex Games catalog.

  • If the game is approved, the draft status will change to Published, and the status on the In-app purchasesInaps tab will change to Purchases are enabled. Your game will become available in the Yandex Games catalog.
  • If the game does not pass moderation, the draft will go to the Rejected status, and we will write to the email why the game was not accepted. Make the necessary changes and go back to step 1.

After enabling purchases, you can change their parameters.

Test purchases

Note

You can test purchases in the game draft, before sending it for moderation and before publication.

To test purchases, add the login to the list for test purchases:

  1. Access the Games Console with your developer account.

  2. In the upper left corner of the console, click Applications.

  3. Find the game you need in the list and click on it.

  4. Go to the In-app purchases tab.

  5. Select Settings.

  6. In the List of logins for test purchases block:

    1. Enter the login Yandex ID that you plan to use for testing purchases.
    2. Click the Add button. The account will appear in the list.

You will be able to test purchases under this account in a few minutes. No fee will be charged for them.

Editing Purchases

After enabling purchases and publishing the game, you can change their parameters. Make sure they match the current game code and update it if necessary. This will require re-moderation. Until then, the previous version of the game remains in the catalogue.

To edit or purchases:

  1. Access the Games Console with your developer account.

  2. In the top left corner of the console, click Applications.

  3. Find the previously uploaded game in the list and click on it.

  4. Go to the tab In-app purchasesInaps.

  5. Find the purchase in the list and click on it:

  6. Make changes to the necessary fields.

  7. Click Edit.

  8. If you changed the game code, upload a new archive.

Deleting purchases

Alert

Don't forget to delete not only the purchase itself, but also the related code. Otherwise, the user will see the purchase in the game but won't be able to use it.

To delete purchases:

  1. Access the Games Console with your developer account.

  2. In the top left corner of the console, click Applications.

  3. Find the previously uploaded game in the list and click on it.

  4. Go to the tab In-app purchasesInaps.

  5. In the table:

    1. Click on the purchase to open the edit window.
    2. Click Remove.
    1. Check the boxes to the left of the purchases you want to select. If you want to select all items, check the box at the top of the purchases table.

      Note

      You can deselect items in one of the following ways:

      • Uncheck the box at the top of the table.
      • On the right side of the panel with the Remove button, click .
    2. Click Remove.

  6. If you have changed the game code, upload the new archive.

Default Icon

Tip

For each in-app purchase, we recommend using unique, clear, and attractive images that match your game's style.

If you don't yet have a unique image for each purchase, or can't create one, you can upload a common icon:

  1. Go to the In-app purchases tab → Settings.
  2. In the Default icon field, click Select file.
  3. Add a file with the following parameters:
    • Size — 256 × 256 pixels.
    • Format — PNG.

The default icon will be displayed for all in-app purchases that don't have a separate image set.

Portal Currency Rate

You can find out the cost of a certain amount of portal currency in real money for different countries:

  1. Access the Games Console with your developer account.

  2. In the top left corner of the console, click Applications.

  3. Find the previously uploaded game in the list and click on it.

  4. Go to the In-app purchases tab.

  5. Select Prices in countries and regions.

  6. In the The cost of 1 in-app <X> yan field, enter the required amount of portal currency. The result will be displayed below in the table columns:

    • Your share — your reward for the purchase made.

    • The price for the player — the cost of the purchase for the player in the currency of their country.

Statistics and Payments for In-Game Purchases

Payments

For granting a license to use the game, Yandex pays a license fee minus taxes (if applicable under the legislation of the Russian Federation).

The reward accumulates until it reaches the payment threshold. As soon as the threshold is reached, Yandex will send you a report with the total amount of the reward by email. The reward itself will be paid the next month.

Note

Income is calculated for all your games that have in-game purchases enabled.

For more details, see section 8. Fees and Payment of the License Agreement.

Statistics

You can view a detailed report on in-game purchases in the Yandex Games console on the Purchase metrics tab.

Comma-separated values.