Интеграция со вторичным рынком (DMarket)

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

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

Основные возможности: 

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

Сценарий взаимодействия пользователя с сервисом DMarket:

  1. Пользователь авторизуется в сервисе.
  2. Сервис получает список доступных для продажи предметов из Инвентаря игрока.
  3. Пользователь размещает предметы из Инвентаря игрока в сервисе.
  4. Пользователь продает или покупает предметы.
  5. Пользователь перемещает предметы из сервиса в Инвентарь игрока.

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

  • Для партнеров, которые уже подключили Магазин и хотят настроить интеграцию вторичного рынка.
  • Для партнеров, которые хотят привлечь или стимулировать игроков, предоставляя им возможность увеличивать доход с помощью продажи игровых предметов.

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

Note:
Описанная в разделе функциональность находится в разработке. Для интеграции сервиса заполните форму обратной связи.

Чтобы интегрировать DMarket, выполните следующие действия:

  1. В Личном кабинете Иксолла перейдите в раздел Настройки проекта > Настройки интеграции и убедитесь, что переключатель Интегрировать методы Commerce API установлен в положение Вкл.
  2. Создайте аккаунт партнера DMarket и получите доступ к личному кабинету.
  3. Получите Partner ID в личном кабинете DMarket.

  1. Сгенерируйте приватный и публичный ключи с помощью алгоритма Ed25519.
  2. Установите ваш публичный ключ в личном кабинете DMarket в поле Partner public key.

  1. Сгенерируйте новый публичный ключ DMarket в личном кабинете DMarket.

  1. После заполнения формы обратной связи и получения ответа передайте в ответном письме следующие данные:
    • Partner ID;
    • приватный ключ, сгенерированный с помощью алгоритма Ed25519;
    • публичный ключ, сгенерированный в личном кабинете DMarket.
  2. Настройте каталог.
  3. Синхронизируйте инвентарь пользователя.
  4. Используйте методы для работы с сервисом DMarket.

Настройка каталога

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

  1. Настроить каталог предметов в Личном кабинете Иксолла.
  2. Настроить каталог предметов в личном кабинете DMarket.
  3. Настроить товары. Для настройки товаров, доступных для продажи в DMarket, заполните форму обратной связи.

Notice:
Параметр Item variant ID в личном кабинете DMarket должен совпадать с артикулом товара в Личном кабинете Иксолла.

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

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

Для синхронизации пользователю необходимо: 

  1. Создать аккаунт DMarket.
  2. Синхронизировать Инвентарь игрока с инвентарем сервиса DMarket путем ввода данных в виджет авторизации Иксолла.

Сценарий аутентификации пользователя и синхронизации аккаунтов:

Методы для работы с сервисом DMarket

Note:
Методы находятся в разработке. Параметры, ссылки и тела запросов могут быть изменены.

Получение списка товаров

Чтобы получить из Инвентаря игрока список товаров, которые могут использоваться в DMarket, в личном кабинете DMarket в поле Get inventory укажите URL https://store.xsolla.com/v2/project/{project_id}/secondary_market/user_inventory, где project_id — ID проекта в Личном кабинете Иксолла.

Перемещение предметов

Чтобы перемещать предметы между Инвентарем игрока и инвентарем в сервисе DMarket, в личном кабинете DMarket в поле Post Task укажите URL https://store.xsolla.com/v2/project/{project_id}/secondary_market/user_inventory/task, где project_id — ID проекта в Личном кабинете Иксолла.

Получение Task

Task — процесс по обмену данными через API при перемещении предметов между инвентарем DMarket и Инвентарем игрока. Чтобы получить информацию о состоянии Task, в личном кабинете DMarket в поле Get Task укажите URL https://store.xsolla.com/v2/project/{project_id}/secondary_market/user_inventory/task/{task_id}, где:

Для интеграции сервиса вторичного рынка заполните форму обратной связи:

Заполнить форму