Создание каталога

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

Каталог ваших товаров должен храниться на стороне Xsolla. Вы можете реализовать это одним из следующих способов:

Перенести уже имеющийся у вас каталог в Xsolla. Вы можете импортировать каталог из PlayFab или Google Play.
Создать каталог на стороне Xsolla. Для этого воспользуйтесь инструкцией.

Импорт каталога

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

Вам понадобится ID проекта и секретный ключ проекта в PlayFab. Также каталог, который вы хотите импортировать в Xsolla, должен быть установлен в PlayFab как базовый (Base).

Откройте проект в Личном кабинете.
Нажмите Магазин в боковом меню.
В панели Управление каталогом нажмите Настроить.
В панели Интеграция с внешними платформами нажмите Настроить.
В панели PlayFab нажмите Настроить.
На вкладке Импорт товаров укажите:
- Title ID — ID проекта в PlayFab.
- Секретный ключ — ключ проекта в PlayFab.
Нажмите Сохранить.
Синхронизируйте инвентарь пользователя с PlayFab (опционально):
1. Перейдите на вкладку Синхронизация инвентаря и укажите:
  - Title ID — ID проекта в PlayFab.
  - Секретный ключ — ключ проекта в PlayFab.
2. Установите переключатель Синхронизировать инвентарь пользователя с PlayFab в положение Вкл.
3. Нажмите Сохранить.
Перейдите на вкладку Импорт товаров и нажмите Начать импорт. Импорт каталога начнется автоматически.
Если вы хотите продавать виртуальные предметы через веб-магазин, созданный с помощью Site Builder, в Личном кабинете создайте группы и укажите для каждого виртуального предмета одну или несколько групп.
Если вы хотите, чтобы у товаров были изображения, необходимо добавить изображения в Личном кабинете.

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

При проверке результатов импорта учитывайте, что пакетом виртуальной валюты считается бандл, который содержит в себе только одну валюту. PlayFab использует виртуальную валюту RM (Real money), которая приравнивается к реальной валюте — 1 цент (100 RM = 1 USD). Например, если вы импортируете из PlayFab 400 RM, в Личном кабинете вы увидите 4 USD.

Откройте проект в Личном кабинете.
Нажмите Магазин в боковом меню.
В панели Управление каталогом нажмите Настроить.
В панели Интеграция с внешними платформами нажмите Настроить.
В панели Google Play нажмите Настроить.
Укажите ID приложения — ID вашего приложения в Google Play.

Вы можете найти ID приложения в консоли администратора Google. В боковом меню нажмите All apps. Найдите в таблице нужное приложение. Его ID будет указан в столбце App рядом с логотипом и названием.

Загрузите JSON-файл с приватным ключом.

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

Перейдите в Google Play Console, в боковом меню нажмите Users and permissions и добавьте сервисный аккаунт как нового пользователя.

Нажмите Сохранить.
Нажмите Начать импорт. Импорт каталога начнется автоматически.

Артикул товара соответствует Product ID в источнике импорта.

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

Для пользователей из Бангладеш цены в каталоге будут отображаться не в валюте BDT, а в базовой валюте USD.

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

Для получения списка предметов, вызовите метод API Получение списка виртуальных предметов:

В заголовке запроса передайте Xsolla Login JWT (Bearer-токен), который используется по умолчанию для авторизации пользователей. Для проверки вызова метода вы можете использовать тестовый токен: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI.
В path-параметре project_id передайте ID проекта, который вы можете найти в Личном кабинете:

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

Прогресс интеграции

Последнее обновление: 9 февраля 2024

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

Your browser is not supported. Please try a different browser

Payments

Создание каталога

Импорт каталога

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