In-game purchases

You can enable in-game purchases and earn revenue by providing paid services in your games.

Paid services may include extra time for completing a level or accessories for an in-game character.

Enable purchases

1. Add the SDK code to the source files of your game.

2. Log in to the Games Console from your developer account.

3. Click Applications in the upper-left corner of the Games Console.

4. Find a previously uploaded game in the list and click its name.

5. Enable monetization. To do this, submit an application to join the Yandex Advertising Network and wait for approval.

   Make sure you have specified the details for advertising and purchase payouts in the YAN partner interface. If the details are not specified, click Add bank details, fill out the form, and save it.

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

   Alert

   You can only enable in-game purchases after accepting the offer.

6. Enable purchases. Send a request to enable purchases to games-partners@yandex-team.com. Make sure your email includes:

   • Game name
   • Game ID

   Note

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

7. Go to the Draft tab and upload the new archive. For a detailed description of the fields, see Add a game.

8. Go to the Purchases tab and click Add purchase. If purchases have already been added to your game, click in the upper-right corner above the list of purchases. You can use any number of purchases in your game.

9. Fill in the fields in the form:

   Field	Description
   ID	Purchase ID to be passed in the payments.purchase method.
   Title	Purchase name in Russian. The name is displayed in the purchase dialog box.
   Description	Purchase description in Russian. The description is displayed in the purchase dialog box.
   Price	Purchase cost for the user, in portal currency.
   Icon	Size: 256 × 256 pixels. Format: PNG. The icon is displayed in the purchase dialog box.

10. Click Add.

11. Click Submit for moderation on the game's page.

    Note

    If your game was under moderation more than 100 days ago, you'll see a warning saying that the requirements may have changed. To check if the game meets the requirements, cancel the submission 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, in the order it was received. Moderation usually takes from three to five working days.

    You can see the results in the dashboard:

    • If the draft passes moderation, its status changes to Verified, the Publish button appears on the Draft tab, and the Purchases are allowed status is shown on the Purchases tab. Proceed to step 12.
    • Otherwise, the draft status changes to Rejected. A notification with a detailed description of the reasons for the rejection will be sent to your email. Make the necessary changes and repeat step 11.

    Tip

    • While moderation is underway, you can test your game.
    • If you don't want to submit the game for moderation immediately, you can save its draft and continue editing the fields later (the draft is saved with the Created status).

12. Click Publish on the Draft tab.

    The draft status changes to Published within a few minutes and the new game version appears in the Yandex Games catalog.

    After enabling purchases, you can:

    • Make any changes to the purchase parameters. After the changes are made, the game must be resubmitted for moderation and checked for compliance.
    • Test purchases using the developer account or another account added to the list of test purchases.

Test purchases

Any user whose login is added to the list for test purchases can check in-game purchases. To add a new login to the list, log in to Yandex services with the account you used to register in the Games Console and follow the instructions below:

1. Log in to the Games Console from your developer account.

2. Click Applications in the upper-left corner.
3. Find the game you need in the list and click its name.
4. Go to the Purchases tab and click Add purchase. If purchases have already been added to your game, click in the upper-right corner above the list of purchases. You can use any number of purchases in your game.
5. Under List of logins for test purchases:

   1. Type the Yandex ID login you want to use for testing purchases.

   2. Click Add. The account appears in the list.

      To delete an account, click next to its name.

A few minutes after changing the list, you'll be able to use the added account to test purchases. You won't be charged for them.

Edit purchases

After enabling purchases and publishing the game, you can make any changes to the purchase parameters or source code. Once you've made the changes, the game must be resubmitted for moderation and checked for compliance.

The new version of the game will become available to users only after successful moderation and publication. Until then, the catalog will display the previous version of the game.

To edit or delete purchases:

1. Log in to the Games Console from your developer account.

2. Click Applications in the upper-left corner of the Games Console.

3. Find a previously uploaded game in the list and click its name.

4. Go to the Purchases tab.

5. Find a purchase in the list and click its name:

   To edit a purchase

   To delete a purchase

   Edit the necessary fields and click Edit.

   Click Remove.

   Alert

   When removing a purchase from the Games Console, be sure to remove the corresponding segment from the game code and upload the new archive. Otherwise, the purchase will remain visible to players, but they won't be able to make it.

6. Upload a new archive if you've made changes to the SDK code.

7. Click Submit for moderation on the Draft tab.

   Moderators will review your app for compliance with the requirements, in the order it was received. Moderation usually takes from three to five working days.

8. You can see the results in the dashboard:

   • If the draft passes moderation, its status changes to Verified, the Publish button appears on the Draft tab, and the Purchases are allowed status is shown on the Purchases tab. Proceed to step 9.
   • Otherwise, the draft status changes to Rejected. A notification with a detailed description of the reasons for the rejection will be sent to your email. Make the necessary changes and go back to step 7.

   Tip

   • While moderation is underway, you can test your game.
   • If you don't want to submit the game for moderation immediately, you can save its draft and continue editing the fields later (the draft is saved with the Created status).

9. Click Publish on the Draft tab.

   The draft status changes to Published within a few minutes and the new game version appears in the Yandex Games catalog.

Statistics and payouts for in-game purchases

Payouts

For being granted a license to use the game, Yandex pays a licensing fee net of taxes (if applicable under the Russian law).

If the revenue amount reaches the minimum threshold in the current month, it is paid out the following month. Otherwise, the amount accumulates until it reaches the payout threshold.

When the minimum payout threshold is reached, Yandex automatically sends a report to the partner's email, stating the total revenue amount. To request detailed statistics on purchases and revenue, contact support.

To learn more, see 8. Fees and payment for the License Agreement.

Statistics

To receive a detailed report on in-game purchases and revenue, write to the support chat. Make sure your message includes:

• A link to the game.
• The time period for which you need statistics.

Once the report with statistics is ready, we'll send it in a reply message. The report includes:

• Number of payments.
• Total refund amount.
• Total amount of test payments (optional).
• Total price: The total amount before fees.
• Total amount for the period: Net revenue after fees.