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
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.
Enable purchases. To do this, send an email with request to enable purchases to games-partners@yandex-team.com. Specify:
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.
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.
Go to the tab In-app purchases → Inaps.
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.
Click the Upload a CSV file button.
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.
Click Import <N> in-apps. The table with purchases will be updated.
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.
Go to the Draft tab.
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.
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:
With the Postpone publication option
Without the option
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 purchases → Inaps 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 purchases → Inaps 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:
Access the Games Console with your developer account.
In the upper left corner of the console, click Applications.
Find the game you need in the list and click on it.
Go to the In-app purchases tab.
Select Settings.
In the List of logins for test purchases block:
Enter the login Yandex ID that you plan to use for testing purchases.
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:
Access the Games Console with your developer account.
In the top left corner of the console, click Applications.
Find the previously uploaded game in the list and click on it.
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:
Access the Games Console with your developer account.
In the top left corner of the console, click Applications.
Find the previously uploaded game in the list and click on it.
Go to the tab In-app purchases → Inaps.
In the table:
Single deletion
Bulk deletion
Click on the purchase to open the edit window.
Click Remove.
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 .
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:
Go to the In-app purchases tab → Settings.
In the Default icon field, click Select file.
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:
Access the Games Console with your developer account.
In the top left corner of the console, click Applications.
Find the previously uploaded game in the list and click on it.
Go to the In-app purchases tab.
Select Prices in countries and regions.
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.