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

SDK enterprise-уровня для Unity

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

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

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

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

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

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

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

Если в мобильном приложении вы открываете платежный интерфейс в WebView, добавьте кнопку для закрытия платежного интерфейса на любом этапе покупки. Для этого используйте параметр close_button в экземплярах класса PurchaseParams при вызове метода SDK XsollaCatalog.Purchase или XsollaCart.Purchase.

Вы можете выбрать значок, который будет отображаться на кнопке. Для этого передайте в параметре close_button_icon в экземплярах класса PurchaseParams одно из следующих значений:

  • “arrow” — для отображения значка (по умолчанию);
  • “cross” — для отображения значка ×.

Пример использования параметров close_button и close_button_icon в WebView:

Инструкции

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

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

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

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

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

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

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

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

  1. Откройте проект в Личном кабинете.
  2. В боковом меню выберите пункт Pay Station.
  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. В поле Задержка введите количество секунд, через которое должен выполняться редирект. По умолчанию автоматический редирект осуществляется с задержкой 0 секунд.

  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.

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

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

Последнее обновление: 23 июля 2024

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

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