Продажа по прямой ссылке

Примечание

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

Дополнительно вы можете настроить в проекте:

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

По ссылке открывается страница оформления заказа Xsolla. На ней пользователь проходит весь путь покупки: оформляет и оплачивает заказ. Разрабатывать для этого свой интерфейс не нужно.

Такой формат подходит в следующих случаях:

  • Нужно быстро запустить продажи игры или предзаказ в разных каналах. Ссылку достаточно разместить на сайте, в соцсетях или рассылке.
  • Нужно сократить число обращений в поддержку из-за неверно указанной почты или несовместимой платформы. Недостающие данные пользователь вводит на странице оформления заказа, а если ключи продаются для нескольких платформ, платформу можно задать заранее в артикуле (см. Формат и параметры ссылки).

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

  1. Пользователь переходит по ссылке.
  2. Xsolla показывает страницу оформления заказа.
  3. Пользователь указывает данные, которые не были переданы в ссылке:
    1. Выбирает платформу, для которой есть ключи.
    2. Вводит промокод (опционально).
    3. Вводит email-адрес, на который придут чек, игровой ключ и инструкция по активации, и нажимает Продолжить.
  1. Страница еще раз показывает введенный адрес. Пользователь подтверждает его или нажимает Изменить и исправляет.
Примечание

Набор шагов для оформления заказа может отличаться:

  • Выбор платформы при оформлении заказа доступен, если артикул пакета игровых ключей передан без указания платформы.
  • Ввод промокода доступен, только если для пакета ключей или бандла есть активный промокод.
  • Для аутентифицированных пользователей email-адрес автоматически подставляется в форму оформления заказа из данных пользователя.
  1. Xsolla резервирует ключ для выбранной платформы и открывает платежный интерфейс.
  2. Пользователь оплачивает покупку.
  3. После успешной оплаты Xsolla отправляет письмо с чеком, игровым ключом и инструкцией по активации на подтвержденный email-адрес.

Ссылка для продажи игровых ключей имеет следующий вид:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

Список query-параметров:

ПараметрОписание
type

Тип товара. Обязательный.

Возможные значения:

project_id

ID проекта, который можно найти:

  • Рядом с названием проекта при его нажатии в хедере Личного кабинета.
  • В URL-адресе любой страницы Личного кабинета. URL-адрес имеет следующий формат: https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/.

Обязательный.

sku

Артикул пакета игровых ключей. Обязательный.

Примеры:

  • game456 — артикул без указания конкретной платформы.
  • game456_steam — артикул с указанием конкретной платформы. Список поддерживаемых Xsolla платформ и примеры суффиксов для них приведен в таблице ниже.

Для корректной работы ссылки вы можете уточнить значение артикула с помощью метода API Получение списка игр. Артикул товара возвращается в параметре items.unit_items.sku (как правило, этот артикул выглядит как game_key_sku_drm_sku).

xsolla_login_tokenТокен аутентификации пользователя (JWT), полученный с помощью Xsolla Login. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
access_dataJSON-объект с данными пользователя и настройками платежа в кодировке Base64. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
authТокен аутентификации пользователя, полученный с помощью Pay Station. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
ui_settingsJSON-объект с настройками темы интерфейса в кодировке Base64. Подробная информация приведена в разделе Кастомизация интерфейса.
modeПередайте значение sandbox, чтобы провести тестовые платежи. Подробная информация приведена в разделе Тестирование оплаты.
ПараметрОписание
type

Тип товара. Обязательный.

Возможные значения:

project_id

ID проекта, который можно найти:

  • Рядом с названием проекта при его нажатии в хедере аккаунта.
  • В URL-адресе любой страницы аккаунта. URL-адрес имеет следующий формат: https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/.

Обязательный.

sku

Артикул пакета игровых ключей. Обязательный.

Примеры:

  • game456 — артикул без указания конкретной платформы.
  • game456_steam — артикул с указанием конкретной платформы. Список поддерживаемых Xsolla платформ и примеры суффиксов для них приведен в таблице ниже.

Для корректной работы ссылки вы можете уточнить значение артикула с помощью метода API Получение списка игр. Артикул товара возвращается в параметре items.unit_items.sku (как правило, этот артикул выглядит как game_key_sku_drm_sku).

xsolla_login_tokenТокен аутентификации пользователя (JWT), полученный с помощью Xsolla Login. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
access_dataJSON-объект с данными пользователя и настройками платежа в кодировке Base64. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
authТокен аутентификации пользователя, полученный с помощью Pay Station. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей.
ui_settingsJSON-объект с настройками темы интерфейса в кодировке Base64. Подробная информация приведена в разделе Кастомизация интерфейса.
modeПередайте значение sandbox, чтобы провести тестовые платежи. Подробная информация приведена в разделе Тестирование оплаты.

Чтобы продавать пакеты игровых ключей для конкретной платформы, необходимо в query-параметре sku передать артикул пакета игровых ключей с суффиксом платформы — автоматически или вручную, в зависимости от того, где создается пакет ключей:

  • Если вы создаете пакеты ключей в аккаунте, к введенному вручную артикулу через нижнее подчеркивание автоматически добавляется суффикс конкретной платформы — например, _steam или _playstation.
  • Если вы создаете пакеты ключей для конкретной платформы с помощью методов API, вы можете указать суффикс платформы в любом удобном для вас формате с использованием только строчных и заглавных латинских букв, цифр, точек, тире и подчеркиваний.

Список поддерживаемых Xsolla платформ и примеры суффиксов для них:

НазваниеПример суффикса
Steam_steam
PlayStation_playstation
Xbox_xbox
Uplay_uplay
Origin_origin
DRM Free_drmfree
GOG_gog
Epic Games_epicgames
Nintendo Switch eShop_nintendo_eshop
Discord Game Store_discord_game_store
Oculus_oculus
Viveport_viveport
Google Stadia_stadia
MY.GAMES Store_my_game

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

Пример ссылки для продажи игры для платформы Steam:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

Кастомизация интерфейса

Чтобы интерфейс страницы оформления заказа соответствовал стилю вашей игры, настройте тему, размер и другие параметры, следуя инструкции по кастомизации. Добавьте в ссылку параметр ui_settings и передайте в нем JSON-объект settings.ui в кодировке Base64.

Пример ссылки для открытия страницы оформления заказа с кастомной темой:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

Продажа для аутентифицированных пользователей

Примечание

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

Дополнительный шаг аутентификации может снизить конверсию в покупки.

Чтобы продавать игровые ключи для аутентифицированных пользователей, добавьте в ссылку один из следующих параметров:

  • xsolla_login_token — JWT-токен, полученный через Xsolla Login. Используйте этот параметр, если вы аутентифицируете пользователей через Xsolla Login. Чтобы получить токен, аутентифицируйте пользователя через Login API, например, с помощью метода Авторизация по имени пользователя и паролю.
  • auth — токен, полученный через Pay Station. Используйте этот параметр, если у вас собственная система аутентификации. Чтобы получить токен, отправьте с вашего сервера запрос Создание токена. Подробная информация приведена в инструкции Получение токена для открытия платежного интерфейса.
  • access_data — JSON-объект, закодированный в Base64, с данными пользователя и настройками платежа. Используйте этот параметр, если у вас собственная система аутентификации или вам нужно передать email-адрес и страну. Структура объекта совпадает с телом запроса метода Создание токена (объект user и объект settings).

Пример JSON для access_data до кодирования:

Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "id": {
 4      "value": "USER_ID"
 5    },
 6    "email": {
 7      "value": "[email protected]"
 8    },
 9    "country": {
10      "value": "US"
11    }
12  },
13  "settings": {
14    "language": "en",
15    "currency": "USD"
16  }
17}

Закодируйте JSON-объект в Base64 и передайте результат в параметре access_data ссылки.

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

Пример ссылки для открытия страницы оформления заказа с токеном аутентификации:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

Тестирование оплаты

Чтобы проверить оплату в тестовом окружении (sandbox-режиме), добавьте параметр mode=sandbox в ссылку. Для проведения платежей вы можете использовать тестовые банковские карты.

Пример ссылки для открытия страницы оформления заказа в тестовом окружении:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Внимание
При покупках в тестовом окружении загруженные ключи не используются. Система имитирует успешную покупку, но не выдает реальные игровые ключи.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 19 ноября 2026

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

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