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

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

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

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

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

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

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

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

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

  1. Откройте проект в Личном кабинете.
  2. В боковом меню выберите пункт Pay Station.
  3. Перейдите в раздел Настройки > Политика редиректа.
  1. В поле Return URL введите URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.
Примечание
Для перенаправления пользователей в мобильное приложение URL-адрес должен соответствовать схеме app://xpayment.<ANDROID_PACKAGE_NAME>, где <ANDROID_PACKAGE_NAME>название пакета Android-приложения.

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

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

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

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

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

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

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

Создайте объект PaymentOptions и передайте его в метод создания заказа (createOrderByItemSku, createOrderFromCartById или createOrderFromCurrentCart). В объекте задайте настройки редиректов:

  1. В параметре settings.returnUrl передайте URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.
Примечание
Для перенаправления пользователей в мобильное приложение URL-адрес должен соответствовать схеме app://xpayment.<ANDROID_PACKAGE_NAME>, где <ANDROID_PACKAGE_NAME>название пакета Android-приложения.

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

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

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

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

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

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

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

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