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

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

Формат и параметры ссылки
Ссылка для продажи игровых ключей имеет следующий вид:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}
Список query-параметров:
| Параметр | Описание |
|---|---|
type | Тип товара. Обязательный. Возможные значения:
|
project_id | ID проекта, который можно найти:
Обязательный. |
sku | Артикул пакета игровых ключей. Обязательный. Примеры:
Для корректной работы ссылки вы можете уточнить значение артикула с помощью метода API Получение списка игр. Артикул товара возвращается в параметре |
xsolla_login_token | Токен аутентификации пользователя (JWT), полученный с помощью Xsolla Login. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
access_data | JSON-объект с данными пользователя и настройками платежа в кодировке Base64. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
auth | Токен аутентификации пользователя, полученный с помощью Pay Station. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
ui_settings | JSON-объект с настройками темы интерфейса в кодировке Base64. Подробная информация приведена в разделе Кастомизация интерфейса. |
mode | Передайте значение sandbox, чтобы провести тестовые платежи. Подробная информация приведена в разделе Тестирование оплаты. |
| Параметр | Описание |
|---|---|
type | Тип товара. Обязательный. Возможные значения:
|
project_id | ID проекта, который можно найти:
Обязательный. |
sku | Артикул пакета игровых ключей. Обязательный. Примеры:
Для корректной работы ссылки вы можете уточнить значение артикула с помощью метода API Получение списка игр. Артикул товара возвращается в параметре |
xsolla_login_token | Токен аутентификации пользователя (JWT), полученный с помощью Xsolla Login. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
access_data | JSON-объект с данными пользователя и настройками платежа в кодировке Base64. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
auth | Токен аутентификации пользователя, полученный с помощью Pay Station. Подробная информация приведена в разделе Продажа для аутентифицированных пользователей. |
ui_settings | JSON-объект с настройками темы интерфейса в кодировке 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:
- http
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam
Кастомизация интерфейса
Чтобы интерфейс страницы оформления заказа соответствовал стилю вашей игры, настройте тему, размер и другие параметры, следуя инструкции по кастомизации. Добавьте в ссылку параметр ui_settings и передайте в нем JSON-объект settings.ui в кодировке Base64.
Пример ссылки для открытия страницы оформления заказа с кастомной темой:
- http
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 для
- json
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 ссылки.
Подробная информация о способах аутентификации и формировании токенов аутентификации приведена в разделе Как настроить аутентификацию для продажи игровых ключей.
Пример ссылки для открытия страницы оформления заказа с токеном аутентификации:
- http
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 в ссылку. Для проведения платежей вы можете использовать тестовые банковские карты.
Пример ссылки для открытия страницы оформления заказа в тестовом окружении:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.