Как настроить редиректы

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

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

    Настройка автоматических редиректов

    Вы можете настроить автоматические редиректы:

  • в Личном кабинете;
  • через API.
  • Notice
    Настройки редиректов через API считаются более приоритетными по сравнению с настройками в Личном кабинете.

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

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

    1. В поле Return URL введите URL-адрес страницы или путь в приложении, на который пользователь должен переходить после совершения платежа.
    2. Выберите значение в поле Условия редиректа:
      • Нет — редирект не выполняется;
      • Successful — редирект при успешном платеже;
      • Successful или Canceled — редирект при успешном или отмененном платеже;
      • Любой платеж — редирект при любых статусах платежа.
    3. В поле Задержка введите количество секунд, через которое должен выполняться редирект.
    4. Нажмите Сохранить.

    Notice
    По умолчанию автоматический редирект осуществляется с задержкой 0 секунд.

    Настройка автоматических редиректов через API

    Настройки редиректа указываются в параметре return_url и группе параметров redirect_policy в методе Создание токена.

    1. В параметре return_url передайте URL-адрес страницы или путь в приложении, на который пользователь должен переходить после совершения платежа.
    2. В параметре autoredirect_from_status_page передайте значение true.
    3. В параметре delay передайте количество секунд, через которое должен выполняться редирект.
    4. В параметре redirect_conditions передайте условия редиректа:
      • none — редирект не выполняется;
      • successful — редирект при успешном платеже;
      • successful_or_canceled — редирект при успешном или отмененном платеже;
      • any — редирект при любых статусах платежа.

    Настройка ручных редиректов

    Вы можете настроить ручные редиректы:

    Notice
    Настройки редиректов через API считаются более приоритетными по сравнению с настройками в Личном кабинете.

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

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

    1. В поле Return URL введите URL-адрес страницы или путь в приложении, на который пользователь должен переходить после совершения платежа.
    2. Выберите значение в поле Условия редиректа:
      • Нет — редирект не выполняется;
      • Successful — редирект при успешном платеже;
      • Successful или Canceled — редирект при успешном или отмененном платеже;
      • Любой платеж — редирект при любых статусах платежа.
    3. Оставьте пустым поле Задержка.
    4. В раскрывающемся списке Статус для ручного редиректа выберите статус платежа, при котором на странице статуса должна появляться кнопка редиректа.
    5. В поле Надпись на кнопке редиректа введите текст кнопки редиректа, при нажатии на которую пользователь перенаправляется на return URL.
    6. Нажмите Сохранить.

    Notice

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

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

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

    Настройка ручных редиректов через API

    Настройки редиректа указываются в параметре return_url и группе параметров redirect_policy в методе Создание токена.

    1. В параметре return_url передайте URL-адрес страницы или путь в приложении, на который пользователь должен переходить после совершения платежа.
    2. В параметре redirect_conditions передайте условия редиректа:
      • none — редирект не выполняется;
      • successful — редирект при успешном платеже;
      • successful_or_canceled — редирект при успешном или отмененном платеже;
      • any — редирект при любых статусах платежа.
    3. В параметре manual_redirection_action передайте действие, которое совершается, когда пользователь закрывает окно платежного интерфейса или нажимает кнопку редиректа:
      • redirect (по умолчанию) — пользователь перенаправляется на return URL.
      • postmessage — при закрытии окна платежного интерфейса отправляется событие close-widget, при нажатии кнопки — событие return. В данном случае пользователь не перенаправляется на return URL. Вам необходимо настроить обработку событий для закрытия платежного интерфейса или редиректа.
    4. В параметре redirect_button_caption передайте текст кнопки, при нажатии на которую пользователь перенаправляется на return URL.
    5. В параметре status_for_manual_redirection передайте статус платежа, при котором появляется кнопка для возврата на return URL:
      • none — редирект не выполняется;
      • successful — редирект при успешном платеже;
      • successful_or_canceled — редирект при успешном или отмененном платеже;
      • any — редирект при любых статусах платежа.

    Notice
    Если платежный интерфейс в мобильной версии открывается в iframe и в параметре ui.desktop.header.close_button передано значение true, при закрытии платежного интерфейса отправляется только postmessage. Это позволяет вам обработать событие и закрыть платежный интерфейс, а пользователю — остаться на странице, с которой был инициирован платеж.

    Примеры настройки редиректов

    ПРИМЕР 1

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

    Для настроек по умолчанию вам необходимо указать URL-адрес в параметре return_url. Кастомизированный автоматический редирект с задержкой 3 секунды может выглядеть следующим образом:

    Copy
    Full screen
    Small screen
      {
          "redirect_policy": {
          "redirect_conditions": "successful",
          "autoredirect_from_status_page": true,
          "delay": 3
        }
      }

      ПРИМЕР 2

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

      Copy
      Full screen
      Small screen
        {
          "redirect_policy": {
            "redirect_conditions": "successful_or_canceled",
            "status_for_manual_redirection": "successful_or_canceled",
            "manual_redirection_action": "postmessage"
          }
        }

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

        В другой раз

        Спасибо за обратную связь!
        Последнее обновление: 24 августа 2021

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

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