Buy Button

Buy Button это комплексное решение для продажи цифровых товаров.

Note: Если вы уже используете продукты Иксоллы и хотите подключить Buy Button, пожалуйста, обратитесь к аккаунт-менеджеру проекта.

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

Шаг 1

Шаг 2

Шаг 3

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

Сценарий интеграции

Чтобы подключить продукт Buy Button:

  1. Зарегистрируйтесь в Личном кабинете Иксолла.
  2. Создайте проект.
  3. Выберите способ монетизации.
  4. Выберите вариант продажи товаров.

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

Создание проекта

  1. Перейдите в раздел Проекты и нажмите кнопку Создать проект.
  2. В настройках проекта:
    1. Укажите URL оповещений.
    2. Сгенерируйте секретный ключ проекта для подписи оповещений.

Способы монетизации

Виртуальная валюта

Виртуальная валюта — решение для продажи внутриигровой валюты. Основные возможности:

  • Продажа пакетов внутриигровой валюты
  • Поддержка акций
  • Баланс пользователя во внутриигровой валюте
  • Автоматическое определение валюты и страны пользователя

Настройка модуля

  1. Перейдите в настройки модуля Виртуальная валюта и задайте следующие параметры:
    • Название.
    • Стоимость за единицу.
    • Изображение.
  2. Создайте необходимое количество пакетов виртуальной валюты и каждому задайте следующие параметры:
    • Цена.
    • Изображение.
  3. Включите отображение пакетов в магазине.

Настройка оповещений

Для решения Виртуальная валюта необходимо реализовать обработку следующих типов оповещений:

Чтобы подтвердить получение оповещения, ваш сервер должен вернуть 204 HTTP код без тела сообщения. Механизм работы оповещений с примерами обработки подробно описан в справочнике API.

Чтобы протестировать оповещения, перейдите в раздел Оповещения в настройках проекта.

Рецепты

Изучите наши рецепты, чтобы попробовать расширенные возможности решения Виртуальная валюта:

Виртуальные предметы

Виртуальные предметы — решение для продажи внутриигрового контента и ресурсов за реальную или виртуальную валюту. Основные возможности:

  • цены в реальной и виртуальной валюте;
  • каталог любого размера: от одноуровневого до многоуровневого;
  • управление доступом к контенту (возможность покупки предмета только по достижении пользователем определенного уровня и т.д.);
  • обычная и расширенная карточки предметов;
  • поддержка акций;
  • баланс пользователя во внутриигровой валюте;
  • автоматическое определение валюты и страны пользователя.

Настройка модуля

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

Настройка оповещений

Для решения Виртуальные предметы необходимо реализовать обработку следующих типов оповещений:

Чтобы подтвердить получение оповещения, ваш сервер должен вернуть 204 HTTP код без тела сообщения. Механизм работы оповещений с примерами обработки подробно описан в справочнике API.

Чтобы протестировать оповещения, перейдите в раздел Оповещения в настройках проекта.

Рецепты

Изучите наши рецепты, чтобы попробовать расширенные возможности решения Виртуальные предметы:

Игровые ключи

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

  • Выбор DRM, на которых будут распространяться ключи и дистрибутивы
  • Выбор платформы для каждой DRM
  • Разные цены для разных DRM
  • Выбор размера и цветовой темы виджета
  • Чаевые разработчику
  • Предзаказы

Возможны два варианта интеграции — базовая и расширенная.

Базовая интеграция

Особенности базовой интеграции:

  • Быстрый запуск
  • Не требует реализации серверной части
  • Подходит для продажи игры без предварительной авторизации пользователя

В процессе интеграции понадобится ID проекта. Параметр отображается в разделе Настройки проекта > Оповещения.

Настройка модуля:

  1. Включите настройку Интеграция без токена в разделе Настройки проекта > Настройки интеграции.
  2. Отключите оповещения в разделе Настройки проекта > Оповещения.
  3. Перейдите в настройки модуля Игровые ключи и нажмите кнопку Новый пакет.
  4. Задайте базовые настройки пакета:
    • Артикул — уникальный идентификатор.
    • Название игры.
    • Краткое описание игры.
  5. Выберите DRM и укажите платформы.
  6. Настройте цены для выбранных DRM.
  7. Загрузите ключи для выбранных DRM.
  8. Добавьте код виджета на сайт игры.

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

Расширенная интеграция

Особенности расширенной интеграции:

В процессе интеграции понадобятся следующие параметры:

  • ID продавца. Параметр отображается в разделе Настройки проекта > Оповещения.
  • Ключ API. Параметр генерируется в разделе Настройки компании > Ключ API.
  • ID проекта. Параметр отображается в разделе Настройки проекта > Оповещения.
  • Секретный ключ проекта. Параметр генерируется в разделе Настройки проекта > Оповещения.

Настройка модуля:

  1. Перейдите в настройки модуля Игровые ключи и нажмите кнопку Новый пакет.
  2. Задайте базовые настройки пакета:
    • Артикул — уникальный идентификатор.
    • Название игры.
    • Краткое описание игры.
  3. Выберите DRM и укажите платформы.
  4. Настройте цены для выбранных DRM.
  5. Загрузите ключи для выбранных DRM.
  6. Добавьте код виджета на сайт игры.

Полный список параметров виджета для расширенной интеграции доступен в справочнике API.

Настройка оповещений

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

Чтобы подтвердить получение оповещения, ваш сервер должен вернуть 204 HTTP код без тела сообщения. Механизм работы оповещений с примерами обработки подробно описан в справочнике API.

Чтобы протестировать оповещения, перейдите в раздел Оповещения в настройках проекта.

Рецепты

Изучите наши рецепты, чтобы попробовать расширенные возможности решения Игровые ключи:

Продажа товаров

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

Прямая ссылка используется для открытия платежного интерфейса в новом окне или в iframe на вашем сайте. Пример использования: разместите на своем сайте баннер с товаром, при нажатии на который открывается платежный интерфейс.

Настройки ссылок отличаются для продаж доступа в игру и виртуальных товаров и виртуальной валюты.

Продажа доступа в игру

БАЗОВАЯ ИНТЕГРАЦИЯ

При базовой интеграции продажи игр для открытия платежного интерфейса используется ссылка:

https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&drm=steam

Добавьте следующие данные в ссылку:

  • идентификатор вашего проекта в Личном кабинете (ваш проект – Настройки проекта – ID проекта)
  • артикул товара

Дополнительные настройки:

Для тестирования используйте следующий URL:
https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

РАСШИРЕННАЯ ИНТЕГРАЦИЯ

При базовой интеграции продажи игр для открытия платежного интерфейса используется ссылка:

https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}=ACCESS_TOKEN
Добавьте следующие данные в ссылку:
  • YOUR_PROJECT_ID – идентификатор вашего проекта в Личном кабинете (ваш проект – Настройки проекта – ID проекта)
  • YOUR_ITEM_SKU – артикул товара
  • TOKEN_TYPE – тип токена: xsolla_login_token для Xsolla Login JWT и access_token для Pay Station Access Token
  • ACCESS_TOKEN – это токен, который формируется в зависимости от типа аутентификации

Для тестирования используйте следующий URL:

https://store.xsolla.com/pages/buy.php?access_token=ACCESS_TOKEN&mode=sandbox

Продажа виртуальных товаров и виртуальной валюты

Для открытия платежного интерфейса при продаже виртуальных товаров и виртуальной валюты используется ссылка:
https://store.xsolla.com/pages/buy.php?type={ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}={ACCESS_TOKEN}

Добавьте следующие данные в ссылку:

  • тип товара:
    • виртуальные товары – virtual_item
    • виртуальная валюта – bundle
  • YOUR_PROJECT_ID – идентификатор вашего проекта в Личном кабинете (ваш проект – Настройки проекта – ID проекта)
  • YOUR_ITEM_SKU – артикул товара
  • TOKEN_TYPE – тип токена: xsolla_login_token для Xsolla Login JWT и access_token для Pay Station Access Token
  • ACCESS_TOKEN – это токен, содержащий информацию о платеже
Для тестирования используйте следующий URL:
https://store.xsolla.com/pages/buy.php?type={ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}={ACCESS_TOKEN}&mode=sandbox
Для создания токена:
  1. Получите токен аутентификации для создания заказа с покупкой.
  2. Создайте заказ. В ответ будет передан токен для открытия платежного интерфейса.

Через виджет

Виджет - это скрипт, который можно встроить на ваш сайт для продажи товаров. Примеры работы виджета можно посмотреть на демостранице.

Код для вставки виджета:

<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
    s.type = "text/javascript";
    s.async = true;
    s.src = "//cdn.xsolla.net/embed/pay2play/3.0.0/widget.min.js";
    s.addEventListener('load', function (e) {
        var widgetInstance = XPay2PlayWidget.create(options);
    }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>
Добавьте следующие данные в ссылку:
  • YOUR-PROJECT-ID – идентификатор вашего проекта в Личном кабинете (ваш проект – Настройки проекта – ID проекта)
  • YOUR-ITEM-TYPE – тип товара:
    • игра – digital_content
    • физический товар – physical_good
    • виртуальный товар – virtual_item
    • виртуальная валюта – virtual_currency
  • YOUR-ITEM-SKU – артикул товара
Дополнительную информацию по настройке виджета можно найти на GitHub.

Через интерфейс магазина

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

На основе Store API

Для продажи товаров вы можете построить клиентскую часть магазина, интегрируя методы Store API:
  1. Получение списка товаров.
  2. Покупка товаров:
Чтобы методы работали корректно, выберите подходящий способ аутентификации пользователей.

На основе демоверсии

Для просмотра возможностей API реализована демоверсия магазина. Ее код размещен на GitHub. Вы можете взять его за основу для построения своей версии.

Настройка аутентификации

Покупки в магазине могут осуществлять как авторизованные, так и неавторизованные пользователи.

Неавторизованные пользователи

Без авторизации можно покупать игры и физические товары.

Для игр используйте вариант покупки в базовой интеграции.

Для физических товаров при вызове методов Store API необходимо в заголовке передавать x-unauthorized-id – идентификатор пользователя. Его можно сгенерировать на клиенте в виде числа или строки. Пример библиотеки для генерации идентификатора.

Авторизованные пользователи

Для авторизации пользователей возможны следующие варианты аутентификации:
  1. Если у вас подключена Авторизация Иксолла, аутентификация запросов выполняется через Xsolla Login JWT.
  2. Если у вас настроена своя система авторизации, для аутентификации запросов используется Pay Station Access Token.

Настройка аутентификации через Авторизацию Иксолла

  1. Настройте проект в Личном кабинете, следуя инструкции.
  2. Реализуйте вызов методов авторизации: с помощью JSON Web Token или по протоколу OAuth 2.0.
Если данные пользователей хранятся на стороне Иксоллы, реализуйте методы:Если данные пользователей хранятся на стороне PlayFab, используйте рецепт для хранилища PlayFab. Если данные пользователей хранятся на вашей стороне, используйте рецепт для собственного хранилища.

Настройка аутентификации через Pay Station Access Token

Алгоритм аутентификации:
  1. Ваш клиент отправляет запрос на аутентификацию на ваш сервер.
  2. Ваш сервер передает Merchant ID и API key на сервер Иксоллы и запрашивает access_token.
  3. Сервер Иксоллы передает access_token на ваш сервер.
  4. Ваш сервер передает access_tokenвашему клиенту.
Возвращенный access_token используется как авторизационный токен для аутентификации запросов, отправляемых клиентом игры.

Способы продвижения

Купоны

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

Посмотреть рецепт

Лейблы

Вы можете прикреплять лейблы (например, "Best Value") для привлечения внимания к виртуальным предметам или пакетам виртуальной валюты.

Посмотреть рецепт

Бонусы

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

  • Виртуальную валюту
  • Триальный период подписки
  • Виртуальный предмет(ы)
  • Игру(ы)
  • Физические предметы (мерчендайз)

Посмотреть рецепт

Рецепты

Изучите наши рецепты, чтобы попробовать расширенные возможности продукта Buy Button:

Туториалы