Промокоды

Как это работает

Основная информация

Акции с промокодами — маркетинговый инструмент для повышения конверсии в покупку и увеличения среднего чека. Промокод применяется к заказу и позволяет пользователю получить:

  • Скидку, которая применяется ко всей покупке или к указанным товарам.
  • Бонусный товар. В качестве бонусных товаров могут использоваться:
    • пакеты виртуальной валюты;
    • игровые ключи;
    • виртуальные предметы;
    • бандлы.

Основные возможности:

  • гибкая настройка бонусов по промокоду — вы можете задать как один тип бонуса (скидка на покупку, скидка на выбранные товары или бонусный товар), так и любую их комбинацию;
  • настройка общего количества погашений в рамках кампании;
  • настройка количества погашений для одного пользователя в рамках кампании;
  • многократная генерация промокодов;
  • применение региональных ограничений для акций и товаров, привязанных к промокоду.
Примечание
Чтобы установить региональные ограничения на акцию, напишите на igs@xsolla.com.

Ограничения:

  • К покупке можно применить только один промокод.
  • Для получения скидки или бонусного товара пользователь должен оплатить покупку.
  • Скидки не применяются к ценам, которые указаны в виртуальной валюте. Если у товара указана цена как в реальной, так и в виртуальной валюте, скидка применяется только к цене, указанной в реальной валюте.
  • Ключ будет отправлен пользователю на почту или в систему владения играми. Если в кампании закончились ключи, пользователь не сможет погасить промокод.
  • Если к акции с промокодами применяются региональные ограничения, пользователь из этого региона не сможет погасить промокод.
  • Если по промокоду в качестве бонуса используется хотя бы один товар с региональным ограничением, пользователь из этого региона не сможет применить промокод.
Пример: По промокоду бонусом предоставляются щит и меч. На щит действует региональное ограничение — доступен для покупки только в США. Если пользователь не из США вводит промокод, в ответе на методы Подтвердите промокод или Погашение промокода вернется ошибка. Пользователь не сможет получить ни один из товаров по промокоду.
Примечание

Вы также можете добавить акции с купонами в свой магазин.

Основные отличия:

  • По купону пользователь может получить только бонусный товар. По промокоду — бонусный товар, скидку на определенный товар или на всю корзину.
  • Промокоды погашаются при совершении покупки, а купоны — сразу после того, как пользователь вводит код и применяет его.

Сценарий пользователя

Примечание
До оплаты покупки пользователь может отменить применение промокода.

Правила применения скидок

Если для товара настроено несколько акций, которые действуют в момент покупки, скидки применяются к стоимости товара последовательно. Порядок применения скидок при этом не имеет значения.

Пример:

Цена игрового ключа — $10. В Личном кабинете для игровых ключей созданы акции:

  • скидочная акция Черная пятница с размером скидки 10% и периодом действия 4–30 ноября;
  • скидочная акция Распродажа с размером скидки 20% и периодом действия 15 ноября — 15 декабря;
  • акция с промокодом на скидку 5% и периодом действия 1–30 ноября.

20 ноября в момент покупки товара действуют обе скидочные акции и акция с промокодом.

Итоговая стоимость игрового ключа будет определена из расчета (($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0,9 × 0,8 × 0,95 и составит $6,84.

Настройка кампании с промокодами

Примечание

Если вы хотите создать акцию с бонусными товарами, вам необходимо сперва настроить эти товары, а затем перейти к настройке акции.

Для создания товаров вручную в проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары. Подробная информация об этом и других способах создания товаров приведена в разделе документации Каталог товаров.

Настройка в Личном кабинете

Чтобы создать новую акцию с промокодами:

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. На вкладке Акции нажмите Создать акцию.
  1. Укажите Название акции.
  2. В раскрывающемся списке Тип акции выберите значение Промокод.
  3. В поле Внешний ID укажите ID акции, используемый для управления акциями с помощью методов API.
  4. Чтобы при погашении промокода применялась скидка на покупку любого товара или корзины:

    1. Установите переключатель Скидка на покупку в положение Вкл.
    1. В поле Скидка укажите процент скидки.

  1. Чтобы при погашении промокода применялась скидка на конкретные товары:

    1. Установите переключатель Скидка на выбранные товары в положение Вкл.
    1. В поле Размер скидки укажите процент скидки.
    1. В раскрывающемся списке Тип товара выберите тип товара, на который будет предоставляться скидка при погашении промокода.
    1. Выберите товары.

  1. Чтобы предоставлять бонусные товары при погашении промокода:

    1. Установите переключатель Бонусные товары в положение Вкл.
    1. В раскрывающемся списке Выберите бонусные товары выберите тип товара, который будет начисляться пользователю при погашении промокода.
    1. Выберите товары, которые будут предоставляться при погашении промокода.
    1. Для виртуальных предметов укажите количество для каждого предмета.
    1. Для игровых ключей укажите, когда будет определена платформа:
      • Если вы хотите заранее назначить конкретную платформу (например, Steam), в раскрывающемся списке Тип выбора DRM-платформы выберите Выбор DRM при генерации кода. Затем выберите платформу из раскрывающегося списка DRM-платформа.
      • Если вы хотите предоставить выбор пользователю, в раскрывающемся списке Тип выбора DRM-платформы выберите Игрок выбирает DRM при активации кода.
    1. Нажмите Далее.

Примечание

Скидка на заказ или товары указывается целым числом и не может превышать 99%. При настройке скидки на конкретные товары или бонусных товаров учтите следующие особенности:

  • Тип товара доступен для выбора, если в вашем проекте создан хотя бы один товар с этим типом.
  • Вы можете настроить товары разного типа. Для переключения между разными типами товаров используйте поле выбора типа товаров.
  1. Настройте ограничения по погашениям промокода:

    1. Чтобы ограничить количество погашений промокодов в рамках акции среди всех пользователей, установите переключатель Ограничить общее количество погашений в положение Вкл и укажите максимальное количество погашений.
    1. Чтобы ограничить количество промокодов, которое может погасить один пользователь в рамках кампании, установите переключатель Ограничить общее количество погашений на пользователя в положение Вкл и укажите максимальное количество погашений на пользователя.
    1. Чтобы ограничить количество погашений любого уникального промокода среди всех пользователей, установите переключатель Ограничить количество погашений каждого уникального промокода в положение Вкл и укажите максимальное количества погашений промокода.
    1. Нажмите Далее.

  1. Укажите период действия акции: часовой пояс, начало и конец периода. Чтобы не указывать конец периода действия акции, установите флажок Без даты окончания.
  2. Нажмите Далее.
  3. Проверьте настройки акции.
  4. Нажмите Сохранить и выйти.

Чтобы добавить промокоды в акцию:

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. В строке необходимой акции с промокодами нажмите ••• и в раскрывающемся списке выберите Редактировать.
  1. Перейдите на вкладку Коды.
  2. Чтобы автоматически сгенерировать коды:
    1. В раскрывающемся списке Формат кода выберите Созданный автоматически.
    1. Укажите количество кодов для генерации и нажмите Сгенерировать.
  1. Чтобы добавить коды вручную:
    1. В раскрывающемся списке Формат кода выберите Введенный вручную.
    1. Введите промокод и нажмите Создать.
    1. Повторите предыдущий шаг, чтобы добавить необходимое количество кодов.
  1. Скачайте CSV-файл с кодами (опционально).
Примечание

Промокод чувствителен к регистру. Например, winter123 и WINTER123 — разные промокоды.

В кампанию можно добавлять новые коды неограниченное количество раз. Однако, общее количество добавленных кодов не должно превышать 50 000.

Если вам требуется загрузить большое количество кодов, которые вы сгенерировали самостоятельно, напишите на igs@xsolla.com.

Чтобы акция стала доступна пользователям, активируйте ее. Для этого:

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Акции.
  2. В строке необходимой акции с промокодами нажмите ••• и в раскрывающемся списке выберите Редактировать.
  3. В раскрывающемся списке в правом верхнем углу выберите Активировать акцию.

Настройка через методы API

Примечание
При настройке акции через API вы можете указывать дробное значение скидки.
Внимание
Список параметров, которые необходимо передать при использовании методов API для обновления акций, не совпадает со списком параметров, которые возвращаются при использовании методов API для получения акций. При вызове методов API обновления акций необходимо передавать:
  • обязательные параметры;
  • параметры, значения которых вы хотите изменить;
  • все остальные параметры, которые были возвращены методом получения акций.

Для настройки и управления акциями с промокодами через API используйте следующие методы:

ЗадачаМетод API
Создать акцию с промокодом.Создание акции с промокодами.
Активировать акцию с промокодом.Активация акции с промокодами.
Отредактировать акцию.Обновление акции с промокодами с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Активная.
Деактивировать акцию.Деактивация акции с промокодами.
Настроить бессрочную акцию.Создание акции с промокодами или Обновление акции с промокодами. Передайте в указанные методы параметр “date_end”: null.
Удалить акцию.Удаление акции с промокодами.
Примечание
Если вы деактивируете или удалите активную акцию, она станет недоступна для пользователей.

Настройка применения промокода в приложении или на сайте

Применение промокода в собственном интерфейсе

  1. В интерфейсе приложения (в каталоге или корзине) реализуйте следующие элементы:

    • поле для ввода промокода;
    • элементы для отображения вознаграждения и скидок по промокоду;
    • форму для выбора вознаграждения по промокоду;
    • кнопку для применения промокода.
  2. Реализуйте логику работы с промокодами с помощью следующих клиентских методов API:

Примечание
Для работы с Xsolla API вы можете использовать готовые методы SDK для игровых движков и платформ:
ЗадачаМетод API
Проверить корректность промокода.Подтвердите промокод.
Получить список платформ распространения игры для отображения пользователю, если в качестве бонуса по промокоду предоставляется игровой ключ.

Получение вознаграждений по промокоду.

Если в ответе возвращается is_selectable=true, для каждого элемента item с type=unit необходимо отобразить форму выбора элементов из объекта unit_items, в которой пользователь сможет выбрать только один элемент для каждого типа unit.

Параметр type=unit передается для игровых ключей. Пользователю в этому случае потребуется выбрать платформу игры.

Отобразить обновленный каталог с учетом скидок и бонусных товаров по промокоду.Методы из подраздела Catalog. В запросе необходимо передать промокод в параметре promo_code.
Купить указанный товар без добавления в корзину и погасить промокод.

Создание заказа с указанным товаром.

В запросе необходимо передать промокод в параметре promo_code.

Применить промокод и обновить данные о составе и стоимости корзины (применить скидки и добавить бонусные товары).

Погашение промокода.

В запросе необходимо передать промокод в параметре coupon_code.

Примечание
Чтобы дополнительно проверять, сколько еще раз пользователь может применить промокод в рамках акции, используйте серверный метод API Информация об ограничении на применение промокодов для указанного пользователя.
  1. Убедитесь, что бонусные товары корректно начисляются пользователю при погашении промокода.
  1. Если вы ранее реализовали в вашем приложении или на веб-сайте магазин внутриигровых товаров, дополнительная настройка не требуется. Товары, привязанные к промокоду, начисляются пользователю также, как при покупке.
Примечание
Игровые ключи отправляются на email-адрес пользователя или в систему владения играми.

Применение промокода на сайте, созданном с помощью Xsolla

Внимание
Вы можете добавить возможность погашения купона или промокода только на сайт, созданный по шаблону Web Shop.

Чтобы поле для ввода кодов отобразилось на вашем сайте:

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. В разделе Сайты выберите ваш сайт и нажмите Открыть Site Builder.
  3. В основной части конструктора выберите место, где вы хотите добавить новый блок и нажмите Добавить блок.
  4. Выберите блок Промокоды.
  5. Кастомизируйте внешний вид блока (опционально):
    • Измените тексты заголовка и описания блока.
    • Настройте пользовательский фон блока.
    • Измените стиль кнопки.
    • Измените текст кнопки для погашения купона.
  6. Чтобы изменения вступили в силу, опубликуйте сайт:

    1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
    1. Установите флажки напротив страниц, которые вы хотите опубликовать.
    1. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

Примечание

Если публикация сайта недоступна, убедитесь, что соблюдаются условия:

  • Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
  • Подписан Лицензионный договор с Xsolla.
  • Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 13 февраля 2026

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!
Не получилось отправить ваш комментарий
Попробуйте еще раз позже или напишите нам на doc_feedback@xsolla.com.