SDK для iOS / Настройка редиректов
 На главную

SDK для iOS

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

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

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

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

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

  • Аутентификация

  • Акции

  • Личный кабинет и атрибуты пользователя

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

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

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

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

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

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

    Внимание
    Если параметры редиректов указаны в Личном кабинете и в момент создания заказа, используются параметры, указанные в момент создания заказа.

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

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

    1. В поле Return URL введите URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.

    Примечание
    Для перенаправления пользователей в мобильное приложение URL-адрес должен соответствовать схеме app://xlogin.<BUNDLE_ID>, где <BUNDLE_ID>идентификатор iOS-приложения.

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

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

    Внимание

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

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

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

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

    Настройка редиректов в момент создания заказа

    Создайте объект paymentProjectSettings и передайте его в метод создания заказа createOrder. В объекте задайте настройки редиректов:

    1. В параметре returnUrl передайте URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.

    Примечание
    Для перенаправления пользователей в мобильное приложение URL-адрес должен соответствовать схеме app://xlogin.<BUNDLE_ID>, где <BUNDLE_ID>идентификатор iOS-приложения.

    1. Чтобы задать параметры автоматического редиректа:
      1. В параметре redirectPolicy.redirectConditions передайте условия редиректа:
        • none — редирект не выполняется;
        • successful — редирект при успешном платеже;
        • successfulOrCanceled — редирект при успешном или отмененном платеже;
        • any — редирект при любых статусах платежа.
      2. В параметре delay передайте количество секунд, через которое должен выполняться редирект.

    1. Чтобы задать параметры ручного редиректа:
      1. В параметре statusForManualRedirection передайте статус платежа, при котором появляется кнопка для возврата на return URL:
        • none — редирект не выполняется;
        • successful — редирект при успешном платеже;
        • successful_or_canceled — редирект при успешном или отмененном платеже;
        • any — редирект при любых статусах платежа.
      2. В параметре redirectButtonCaption передайте текст кнопки, при нажатии на которую пользователь перенаправляется на return URL.

    Внимание

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

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

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

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

    Прогресс интеграции
    Спасибо за обратную связь!
    Последнее обновление: 2 декабря 2022

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

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