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

SDK для Android

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

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

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

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

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

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

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

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

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

  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.

В качестве примера настройки редиректа в момент создания заказа вы можете использовать демопроект.
Прогресс интеграции
Спасибо за обратную связь!
Последнее обновление: 22 января 2024

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

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