Настройка продажи товаров

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

Для открытия платежного интерфейса используется ссылка:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}

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

  • YOUR-ITEM-TYPE — тип товара:
    • game — игра; game_key — для продажи конкретной DRM-игры.
    • physical_item — физический товар.
    • virtual_item — виртуальный товар.
    • virtual_currency — виртуальная валюта.
    • bundle — пакет виртуальной валюты или бандл.
  • YOUR-PROJECT-ID — идентификатор вашего проекта из раздела Настройки проекта > Общие настройки > ID проекта в Личном кабинете.
  • YOUR-ITEM-SKU — артикул товара. Для продажи конкретной DRM-игры необходимо получить артикул DRM с помощью запроса Get games list на список товаров в каталоге внутриигрового магазина (как правило, этот артикул выглядит как unit_name_drm_sku).

  • Внешний вид платежного интерфейса: тема (темная — dark или светлая — default), размер и другие. Укажите в URL ссылки параметр ui_settings и в качестве значения передайте JSON-объект settings.ui в кодировке Base64. Пример URL с настройками UI:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

  • Токен для передачи информации о пользователе. Используется только при продаже товаров для авторизованных пользователей и обязателен для виртуальных товаров и виртуальной валюты. Формируется в зависимости от типа аутентификации. Пример URL с токеном:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

  • Параметр mode=sandbox для тестирования оплаты. Вы можете использовать тестовые банковские карты для проведения платежей. Пример URL для тестирования:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

Продажа через виджет

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

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

Copy
Full screen
Small screen
<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        user: "ACCESS_TOKEN",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.2/widget.min.js";
        s.addEventListener('load', function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
          }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>

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

  • YOUR-PROJECT-ID — идентификатор вашего проекта из раздела Настройки проекта > Общие настройки > ID проекта в Личном кабинете.
  • YOUR-ITEM-TYPE — тип товара:
    • game — игра; game_key — для продажи конкретной DRM-игры.
    • physical_item— физический товар.
    • virtual_item — виртуальный товар.
    • virtual_currency — виртуальная валюта.
    • bundle — пакет виртуальной валюты или бандл.
  • YOUR-ITEM-SKU — артикул товара. Для продажи конкретной DRM-игры необходимо получить артикул DRM с помощью запроса Get games list на список товаров в каталоге внутриигрового магазина (как правило, этот артикул выглядит как unit_name_drm_sku).
  • ACCESS_TOKEN — токен для передачи информации о пользователе. Используется только при продаже товаров для авторизованных пользователей и обязателен для виртуальных товаров и виртуальной валюты. Формируется в зависимости от типа аутентификации.

Дополнительную информацию по настройке виджета можно найти на GitHub.

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

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

На основе Commerce API

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

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

Note
При продаже игры через методы Commerce API необходимо реализовать на клиенте выбор конкретной DRM. В качестве артикула необходимо передавать значение параметра items.unit_items.sku из запроса на получение списка игр.

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

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

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!

Продолжить чтение

Следующие шаги

Настройка оповещений
Последнее обновление: 23 июля 2021

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

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