In-game purchases

Enable in-app purchases and earn from paid services (extra time to complete levels, accessories for the game character, etc.).

Enable purchases

Step 1. Submit a Connection Request

1. Enable monetization. To do this, apply for joining the Yandex Advertising Network (YAN) and wait for its approval.

   Make sure that in the YAN partner interface you have specified the details for advertising and purchase payouts. If not, click the Add bank details button, fill in the fields, and submit the data.

   After verifying the data, the contract status in the YAN interface, under Extras → Documents, will change to Offer accepted.

   Alert

   In-game purchases can only be connected after the offer acceptance.

2. Connect purchases. To do this, send a connection request email to games-partners@yandex-team.com. Include:

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

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

Step 2. Update Game Source Files

1. Add the SDK code to the game's source files.

2. Access the Games Console with your developer account.

3. In the top left corner of the console, click Applications.
4. Find the previously uploaded game in the list and click on its name.
5. Go to the Draft tab.
6. Edit the fields and upload a new archive. For a detailed description of the fields, see Add Game.

Step 3. Add Purchases

1. Go to the Purchases tab.

2. Click Add purchase. If the game already has purchases added, click in the top right corner.

   Note

   Any number of purchases can be used in the game.

3. Fill in the fields:

   Field	Description
   ID	The purchase identifier, which will be passed in the payments.purchase() method.
   Title	The title of the purchase in Russian. It will be displayed in the payment dialog window.
   Description	Description of the purchase in Russian. It will be displayed in the payment dialog window.
   Price	The cost of the purchase for the user in portal currency.
   Icon	Size — 256 × 256 pixels. Format — PNG. It will be displayed in the payment dialog window.

4. Click Add.

Step 4. Publish the new version of the game

1. Go to the Draft tab.

2. If you want to choose the moment of the game's publication 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.

You will see the results of the check in the console:

• If the game does not pass moderation, the draft will move to the Rejected status, and we will email you explaining why the game was not accepted. Make the necessary changes and return to step 1.

After connecting purchases, you can edit their parameters.

Test purchases

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

1. Access the Games Console with your developer account.

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

3. Find the required game in the list and click on its title.

4. Go to the Purchases tab.

5. 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 with this account in a few minutes. There will be no charge for them.

Edit purchases

After connecting purchases and publishing the game, you can change the purchase parameters and/or source code. This will require re-moderation. Before this, the previous version of the game remains in the catalog.

To edit or 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 its title.

4. Go to the Purchases tab.

5. Find the purchase in the list and click on its title:

   Edit purchase

   Delete purchase

   1. Make changes to the necessary fields.
   2. Click Edit.

   Click the Remove button.

   Alert

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

6. If you've made changes to the game's code, upload a new archive.

7. Publish a new version of the game.

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 its name.

4. Go to the Purchases tab.

5. Select Prices in countries and regions.

6. Enter the required amount of portal currency:

   • Your share for <N> yan — your reward for a completed purchase.
   • Cost <N> yan for the player — the cost of the purchase for the player in the currency of their country.

   Note

   The input fields are not interconnected, so the values need to be changed separately.

Statistics and Payouts for In-Game Purchases

Payouts

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

The reward accumulates until it reaches the payout threshold. Once the threshold is reached, Yandex will send you a report via email with the total amount of the reward. The reward itself will be paid in the following month.

For more details, see section 8. Compensation and Calculations 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.