SDK для Unity / Основная информация
  На главную

SDK для Unity

Основная информация

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

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

  • Для настольных приложений SDK позволяет открывать платежный интерфейс во внутреннем браузере приложения.
  • Для мобильных приложений платежный интерфейс открывается во внешнем браузере.
  • Для WebGL виджет платежного интерфейса открывается в iframe на той же странице браузера.

SDK поддерживает покупку товаров из каталога в один клик или через корзину.

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

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

Инструкции

Узнайте о дополнительных настройках из наших инструкций.

Как настроить перенаправление пользователя в приложение после оплаты

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

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

Вы можете задать параметры редиректов:

  • в Личном кабинете — используйте этот вариант, если вы настраиваете проект для одного приложения и не планируете создавать сборки под разные платформы;

  • в настройках SDK — используйте этот вариант, если вы планируете:
    • использовать проект для нескольких приложений;
    • создавать сборки под разные платформы;
    • продавать внутриигровые товары через веб-сайт.
Внимание
Если параметры редиректов указаны в Личном кабинете и в настройках SDK, используются параметры, указанные в настройках SDK.

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

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

Приложение URL-адрес должен соответствовать одной из схем:

Вы можете найти значение <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> в настройках проекта Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

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

По умолчанию текст на кнопке редиректа — Вернуться в игру. Эта надпись локализована на все языки платежного интерфейса.

Если ваш проект поддерживает несколько языков, вы можете указать текст кнопки для каждого языка в соответствующих полях.

Когда пользователь закрывает платежный интерфейс, он переходит на указанный return URL.

  1. Нажмите Сохранить.

Настройка редиректов в SDK

  1. Откройте ваш проект Unity.
  2. В главном меню выберите пункт Window > Xsolla > Edit Settings.
  3. Откройте панель Inspector и перейдите в раздел Pay Station > Redirect Policy.
  4. Перейдите в раздел, соответствующий платформе сборки вашего приложения (Desktop, WebGL, Android илиiOS), и укажите параметры редиректов:
    1. Снимите флажок Use setting from Publisher Account.
    2. В поле Return URL введите URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.
Примечание

Приложение URL-адрес должен соответствовать одной из схем:

Вы можете найти значение <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> в настройках проекта Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

    1. Чтобы задать параметры автоматического редиректа:
      1. Выберите значение в поле Redirect Conditions:
        • None — редирект не выполняется;
        • Successful payment — редирект при успешном платеже;
        • Successful or canceled payment — редирект при успешном или отмененном платеже;
        • Any payment — редирект при любых статусах платежа.
      2. В поле Redirect Timeout введите количество секунд, через которое должен выполняться редирект.
    1. Чтобы задать параметры ручного редиректа:
      1. Выберите значение в поле Status for Manual Redirection:
        • None — кнопка редиректа не появляется;
        • Successful payment — кнопка редиректа появляется при успешном платеже;
        • Successful or canceled payment — кнопка редиректа появляется при успешном или отмененном платеже;
        • Any payment — кнопка редиректа появляется при любых статусах платежа.
      2. В поле Redirect Button Caption введите текст кнопки редиректа, при нажатии на которую пользователь перенаправляется на return URL.
Внимание

По умолчанию текст на кнопке редиректа — Вернуться в игру. Эта надпись локализована на все языки платежного интерфейса.

Если ваш проект поддерживает несколько языков, вы можете указать текст кнопки для каждого языка в соответствующих полях.

Когда пользователь закрывает платежный интерфейс, он переходит на указанный return URL.

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

Как настроить платежи через Steam

Внимание
Используйте эту инструкцию, если вы включили демопроект в свой проект Unity.

Иксолла может выступать платежным шлюзом при оплате внутриигровых покупок через Steam. При этом вам не требуется интегрировать Steam SDK и учитывать особенности оплаты через Steam при реализации внутриигрового магазина.

Чтобы настроить платежи через Steam:

  1. Подпишите дополнительное соглашение с Иксоллой.

Примечание
Иксолла взимает сниженный процент revenue share при проведении платежей через Steam. Уточните условия у аккаунт-менеджера проекта.
  1. Настройте прямой аккаунт для Steam в Личном кабинете.
  2. Подключите нативную авторизацию через Steam.
  3. Откройте проект Unity.
  4. В главном меню выберите пункт Window > Xsolla > Demo Settings.
  5. В панели Inspector в раскрывающемся списке Payments Flow выберите значение Steam Gateway.

После изменения настроек проекта Unity к запросу платежного токена с помощью метода PurchaseItem добавится заголовок x-steam-userid.

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

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

Последнее обновление: 6 марта 2024

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

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