Skip to main content
API подарков позволяет купить Steam-игру и отправить её другому пользователю через ссылку для добавления в друзья Steam. Покупка происходит через намерение — сначала создаётся намерение, затем выставляется счёт на оплату.
Перед тем как создавать намерение, вы можете проверить доступность игры и получить актуальную цену с помощью метода проверки подарка.
Для того чтобы получить список доступных игр в каталоге, используйте метод загрузки каталога. Для получения информации о конкретной игре и её изданиях используйте метод получения информации об игре.
{
  "games": [
    {
      "appId": 292030,
      "slug": "steam-292030",
      "title": "The Witcher 3: Wild Hunt",
      "headerImage": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg",
      "shortDescription": "You are Geralt of Rivia, mercenary monster slayer. Before you stands a war-torn, monster-infested continent you can explore at will.",
      "genres": ["RPG"],
      "price": {
        "paymentAmount": 199900,
        "paymentCurrency": "RUB",
        "paymentAmountFull": 299900,
        "discountPercent": 33
      }
    },
    ...
  ],
  "total": 42
}

Работа с изданиями

У каждой игры может быть несколько изданий (стандартное, делюкс, полное). Для просмотра всех доступных изданий и их цен используйте метод получения информации об игре с appId нужной игры.
{
  "appId": 730,
  "title": "The Witcher 3: Wild Hunt",
  "editions": [
    {
      "edition": "Standard Edition",
      "packageId": 40499,
      "regions": [
        {
          "region": "US",
          "paymentAmount": 199900,
          "paymentCurrency": "RUB",
          "paymentAmountFull": 299900,
          "discountPercent": 33
        }
      ]
    }
  ]
}
При создании намерения необходимо передать packageId выбранного издания в поле target.packageId.

Работа с регионом

Поле target.region — двухбуквенный код страны по ISO 3166-1 alpha-2 (например, US, DE, TR). Регион влияет на доступность и цену игры. Рекомендуется запрашивать у геймера его регион или определять его автоматически.

Как работает доставка

После успешной оплаты наша система автоматически добавляется в друзья через переданную ссылку (target.inviteUrl) и отправляет игру в подарок. Геймер получает подарок в своей библиотеке Steam.