SDK для Android / Интеграция с серверами Иксоллы
 На главную

SDK для Android

  • Библиотека Login

  • Библиотека Store

  • Библиотека Inventory

  • Библиотека Payments

  • Библиотека Subscriptions

  • Инструкции

  • Интеграция с серверами Иксоллы

    При этом типе интеграции на стороне Иксоллы выполняются следующие задачи:

    • хранение и управление каталогом товаров;
    • управление ценами;
    • хранение данных о региональных ценах;
    • управление региональными ограничениями;
    • управление правами пользователей;
    • управление инвентарем;
    • управление рекламными кампаниями;
    • аутентификация пользователей;
    • обработка транзакций.

    Вам не нужно настраивать собственную серверную часть и базу данных для этих задач.

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

    После завершения интеграции вы можете протестировать процесс оплаты.

    Чтобы интегрировать библиотеку Payments:

    1. Загрузите и установите Android Studio.
    2. Создайте новый проект.
    3. Настройте проект в Личном кабинете.
    4. Настройте модуль Виртуальная валюта (опционально).
    5. Настройте модуль Виртуальные предметы (опционально).
    6. Настройте Платежи.
    7. Получите токен.
    8. Установите библиотеку.
    9. Настройте обработку событий.

    Свяжитесь с командой интеграции
    Нажмите на иконку чата в правом нижнем углу и напишите команде интеграторов в любом мессенджере. В режиме живого общения мы ответим на вопросы и поможем решить проблемы.
    Note
    Данное руководство включает в себя минимальный набор настроек для быстрого запуска. Если у вас возникли вопросы по подключению, обратитесь к аккаунт-менеджеру проекта или напишите на integration@xsolla.com.

    Создание проекта в Личном кабинете

    1. Зарегистрируйтесь в Личном кабинете.
    2. Настройте проект:
      1. Чтобы заполнить данные об игре автоматически, укажите Ссылку на вашу игру на любой платформе. В результате в настройки проекта добавятся изображение игры, ее название и описание.
      2. Чтобы заполнить данные об игре вручную, перейдите по ссылке У меня нет ссылки, настроить вручную и укажите:
        • языки проекта (английский установлен по умолчанию);
        • название проекта на всех добавленных языках;
        • сайт игры (опционально).
      3. Нажмите Создать проект.

    В процессе интеграции вам понадобится ID проекта, который можно найти в Личном кабинете рядом с названием вашего проекта.

    Настройка модуля Виртуальная валюта

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

    1. Нажмите Подключить в панели Виртуальная валюта.

    1. Создайте виртуальную валюту:
      1. Нажмите Создать виртуальную валюту.

      1. Укажите следующую информацию:
        • артикул;
        • название валюты;
        • стоимость единицы виртуальной валюты;
        • валюта по умолчанию;
        • признак премиум-валюты (опционально);
        • изображение (опционально).
      2. Нажмите Создать валюту.

    1. Создайте пакеты виртуальной валюты (опционально):
      1. Перейдите в Пакеты.
      2. Нажмите Создать пакет.

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

      1. Установите переключатель Показывать в магазине в положение Вкл.
      2. Нажмите Создать пакет.

    Note
    Библиотека поддерживает покупку виртуальных предметов за виртуальную валюту, а также потребление виртуальной валюты в случаях, предусмотренных внутриигровой логикой (например, открытие локации, поднятие уровня за валюту). Потребление виртуальной валюты выполняется при вызове метода SDK Xstore.consumeItem.

    Настройка модуля Виртуальные предметы

    Note
    Методы SDK поддерживают следующие типы предметов:
    • Расходуемый предмет — предмет, который можно начислить или купить множество раз. Исчезает из инвентаря в процессе игры. Примеры: гранаты и пули для атаки противников, аптечка.
    • Нерасходуемый предмет — предмет, который можно начислить или купить только один раз, не исчезает из инвентаря. Примеры: доступ к локации, статус, подписка.
    • Непродлеваемая подписка — нерасходуемый предмет, который имеет период доступности, не исчезает из инвентаря. Примеры: премиум-доступ, сезонный доступ. Подробная информация о непродлеваемых подписках приведена в документации по продукту Внутриигровой магазин.

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

    1. Нажмите Подключить в панели Виртуальные предметы.

    1. Нажмите Создать группу.

    1. Укажите Код группы и Название группы.
    2. Установите переключатель Показывать группу в магазине в положение Вкл.
    3. Нажмите Создать группу.

    1. Создайте предметы:
      1. Для каждого предмета укажите следующую информацию:
        • одна или несколько групп, к которым принадлежит предмет;
        • артикул;
        • название и краткое описание;
        • цены в реальной и виртуальной валюте;
        • изображение (опционально).

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

    1. Убедитесь, что статус группы Включен.

    Настройка Платежей в Личном кабинете

    1. Перейдите в свой проект и нажмите Открыть в разделе Платежи. Если вы ранее не установили продукт Магазин, нажмите Подключить в разделе Платежи.

    1. Откройте настройки продукта Платежи.
    2. Укажите Return URL и Условия редиректа в разделе Политика редиректа и нажмите Сохранить.

    Note
    Для перенаправления пользователей в Android-приложение return URL должен соответствовать схеме app://xpayment.<ANDROID_PACKAGE_NAME>, где <ANDROID_PACKAGE_NAME> — название пакета Android-приложения.

    Получение токена

    Для корректной работы SDK нужен токен. Токен — это строка, которая используется для инициации процесса оплаты.

    Вы можете получить токен используя метод Create Order with All Items from Particular Cart библиотеки Store Иксолла. Или вы можете использовать другой токен, например, токен, полученный от PlayFab.

    Установка библиотеки

    Библиотека доступна в Maven Central.

    Для установки библиотеки:

    1. Запустите Android Studio.
    2. Откройте файл build.gradle вашего приложения.
    3. Добавьте следующую строку в раздел зависимостей, где <version_number> — необходимая версия библиотеки Payments:

    Последняя версия:

    Copy
    Full screen
    Small screen
    implementation 'com.xsolla.android:payments:<version_number>'

    Тестирование процесса оплаты

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

    Для тестирования оплаты на реальных платежах:

    1. Убедитесь, что вы заключили договор с Иксоллой.
    2. Установите .isSandbox(false) при сборке объекта Intent Paystation.

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

    В другой раз

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

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

    Последнее обновление: 6 мая 2022

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

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