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.
Alert
Before adding purchases, please configure unprocessed payments verification.
This verification is mandatory for passing moderation, so it's crucial to set it up even for test purchases. If you add purchases to the game and test them before configuring consumption, unprocessed payments could remain after the tests, making passing moderation impossible.
Enable purchases
-
Add the SDK code to the source files of your game.
-
Log in to the Games Console from your developer account.
-
Click Applications in the upper-left corner of the Games Console.
-
Find a previously uploaded game in the list and click its name.
-
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.
-
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.
-
Go to the Draft tab and upload the new archive. For a detailed description of the fields, see Add a game.
-
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.
-
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.
-
Click Add.
-
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).
-
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
Note
You can test purchases in the game draft before moderation and publication.
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:
-
Log in to the Games Console from your developer account.
- Click Applications in the upper-left corner.
- Find the game you need in the list and click its name.
- 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.
- Under List of logins for test purchases:
-
Type the Yandex ID login you want to use for testing purchases.
-
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:
-
Log in to the Games Console from your developer account.
-
Click Applications in the upper-left corner of the Games Console.
-
Find a previously uploaded game in the list and click its name.
-
Go to the Purchases tab.
-
Find a purchase in the list and click its name:
To edit a purchaseTo delete a purchaseEdit 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.
-
Upload a new archive if you've made changes to the SDK code.
-
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.
-
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).
-
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.
Note
Revenue is calculated for all of the developer's games that have enabled in-game purchases.
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.
Note
The message must be sent from the account you specified in the Games Console.
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.
Note
Once the minimum payment threshold is reached, a report with the total revenue amount is automatically sent to your email.