Free game keys

How it works

Free game keys are a type of item that the user can get without spending virtual or real currency.

Examples of usage:

  1. You can give away free DLC to users who already own the main game to reward their loyalty.
  2. You can gift games for a limited time to attract new users.

How to get it

  1. Create a free game key in one the following ways:
  2. Set up delivery of free game keys.

Create via Publisher Account

To create a free game key:
  1. Open your project in Publisher Account.
  2. Click Store in the side menu.
  3. In the Game key pane, click:
    • Connect – if you don’t have game keys
    • Configure – if you previously connected game keys
  4. On the Game keys tab, click New game key package > Create manually.
  5. Set the basic package settings:
    • SKU
    • Game title
    • Attributes (optional)
  6. Click Save and continue.
  7. Select the game distribution platforms and upload a CSV or TXT file with keys.
  8. If you want to sell the game before its official release, set the Pre-orders switch to On. You can specify the release date when the game keys will be delivered to users when creating the keys or later.
  9. Click Save and continue.
  10. Toggle Free game key.
  11. If the game is published on the Steam platform, you can import pricing settings from that platform. To do this, click Import via link and specify the link to your game on Steam.
  12. You can set a limit for purchasing a game key. To do this, switch the Limit the number of times one user can buy game key toggle to On and specify the number of keys a user can purchase.
The limit will work if purchased for real currency when a payment token is created. The user’s email-address is not considered a unique identifier, so the user will be able to get an unlimited number of free keys.

  1. Click Save and continue.

To make changes to the created game keys package, select the key on the Game Keys tab, make changes, and save.

Create via API calls

  1. To create free game keys, use API calls from the Admin subsection in the Game keys method group. When creating or editing an item, pass is_free = true in the request body. This setting is located in an array of unit_items objects in the request body.
  2. To create an order with free items, call the Create order with specified free item API.
  3. Get a user’s order status.
This is required if the order contains a bundle that includes a virtual item or currency. If the order contains only free game keys, the step can be skipped.

Set up delivery of free game keys

Fast purchase

If a user uses fast purchase (a user doesn’t use a cart), then call the Create order with specified free item AP to allow them to receive free keys. The delivery of free game keys to the user’s inventory occurs immediately after a successful request to this method (without the need to open the Pay Station payment form).

Cart purchase

If the user uses cart purchase:
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: January 22, 2024

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!