Апгрейды

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

Апгрейд позволяет пользователям покупать более дорогой пакет игры, оплачивая только стоимость перехода. Для каждого апгрейда цена задается отдельно.

Note: Апгрейд возможен только для предзаказов или игры, распространяемой через DRM-free дистрибутивы. Для апгрейда нельзя настроить акции, региональные ограничения и подарок другу.

Для кого подходит

  • Партнеры, у которых в проекте включена интеграция без токена и подключен продукт Магазин с модулем Игровые ключи.
  • Партнеры, у которых в проекте включена интеграция с токеном и подключены продукты Авторизация и Магазин с модулем Игровые ключи.

Как настроить

Подключение апгрейдов при бессерверной интеграции:

  1. В разделе Игровые ключи Личного кабинета выберите пакет или создайте новый.
  2. Настройте предзаказ или DRM-free дистрибутив. Для настройки DRM-free дистрибутива:
    1. В разделе Базовые настройки выберите DRM-free.
    2. В разделе Ключи и дистрибутивы выберите Загрузка дистрибутива для распространения.
  3. Обратитесь к вашему аккаунт-менеджеру или напишите на am@xsolla.com для включения апгрейдов и настройки их стоимости.
  4.  Настройте отправку писем с апгрейдами:
    1. Добавьте на сайт кнопку для покупки апгрейда и форму для запроса email пользователя.
    2. Реализуйте вызов метода Отправка письма с апгрейдами, который позволяет аутентифицировать пользователя по email и определить, какие пакеты он приобрел ранее.
    3. Передайте в запросе объект access_data с email пользователя и артикул пакета, на который пользователь делает апгрейд.
    4. При выборе апгрейда пользователю отправляется письмо с выбранным пакетом и списком всех доступных пакетов, до которых можно совершить апгрейд.

Пример письма, которое получит пользователь:

Показать

Подключение апгрейдов при серверной интеграции:

  1. В разделе Игровые ключи Личного кабинета выберите пакет или создайте новый.
  2. Настройте предзаказ или DRM-free дистрибутив. Для настройки DRM-free дистрибутива:
    1. В разделе Базовые настройки выберите DRM-free.
    2. В разделе Ключи и дистрибутивы выберите Загрузка дистрибутива для распространения.
  3. Реализуйте вызов методов API Список игр и Список апгрейдов.
  4. Настройте обработку следующих оповещений:
    1. Успешный платеж и Отмена платежа — данные об апгрейде передаются в объекте purchase.pin_codes.upgrade.
    2. Отмена апгрейда.
  5. Обратитесь к вашему аккаунт-менеджеру или напишите на am@xsolla.com для включения апгрейдов и настройки их стоимости.
  6. Для открытия платежного интерфейса при покупке апгрейда передайте в токене следующие параметры:
    1. user.id
    2. purchase.pin_codes.upgrade.id_user_history, получаемый из списка игр;
    3. purchase.pin_codes.upgrade.id, получаемый из списка апгрейдов.

Если пользователь купил несколько последовательных апгрейдов для одного пакета, а затем отменил платеж за один из них, выполняется отмена данного апгрейда и всех последующих. По умолчанию платежи за последующие апгрейды не возвращаются. Если вы хотите настроить отмену платежей для цепочки апгрейдов, обратитесь к вашему аккаунт-менеджеру или напишите на am@xsolla.com.

Note: Для авторизации пользователя и получения user.id вы можете использовать Авторизацию Иксолла.