Способы возвращения пользователя к веб-сервису

Payment Page позволяет управлять способом возврата пользователей в проект после совершения платежа на Payment Page. Данные настройки управляются несколькими параметрами, отправляемыми в запросе на проведение платежа. Далее приведены эти параметры и их возможные значения.

URL-адреса для возврата

Для настройки URL-адреса, на который вернется пользователь передайте merchant_success_url и merchant_fail_url или redirect_fail_url и redirect_success_url с указанием ссылок для перенаправления в случае проведенного или отклоненного платежа. В первом случае с merchant_success_url и merchant_fail_url пользователю отобразится страница с результатом на Payment Page и кнопкой возврата, по нажатии на которую происходит перенаправление на указанный URL. Во втором случае с redirect_fail_url и redirect_success_url пользователь перенаправится автоматически после оплаты на указанный URL без дополнительных шагов и страницы с результатом.

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

Для возможности пользователю вернуться в проект со страницы оплаты на стороне внешнего провайдера по кнопке возврата на любом шаге до завершения оплаты передайте URL-адрес в параметре redirect_return_url. Подробнее о возможности подключения данной функциональности уточняйте у курирующего менеджера ecommpay.

Также вы можете управлять способами возврата в зависимости от браузера, который использует пользователь. Подробную информацию уточняйте у службы технической поддержки support@ecommpay.com.

Возможность возврата

Для включения возможности возврата пользователя после проведенного платежа передайте merchant_success_enabled, после отклоненного платежа — merchant_fail_enabled, на любом шаге оплаты по кнопке возврата merchant_return_enabled с одним из значений:
  • 0 — выключено
  • 1 — только в режиме перенаправления (полная страница)
  • 2 — в режиме перенаправления и в режиме iframe (на сайте мерчанта)

Режим возврата

Для настройки режима открытия страницы проекта во время возврата пользователя после проведенного платежа передайте merchant_success_redirect_mode/redirect_success_mode, после отклоненного платежа — merchant_fail_redirect_mode/redirect_fail_mode, на любом шаге оплаты по кнопке возврата merchant_return_redirect_mode с одним из значений:
  • iframe — открытие в режиме iframe (встроенной в веб-страницу)
  • parent_page — открытие в модальном окне
  • blank_page — открытие на новой вкладке браузера

Примеры режимов возврата

Если Payment Page открыт в режиме iframe:
merchant_success_redirect_mode merchant_fail_redirect_mode merchant_return_redirect_mode merchant_success_enabled merchant_fail_enabled merchant_return_enabled Ожидаемый результат
iframe 0 нет кнопки для возврата
1 перенаправления нет, обработка JavaScript оповещений
2 перенаправление в iframe
parent_page 0 нет кнопки для возврата
1 перенаправления нет, обработка JavaScript оповещений
2 перенаправление всей страницы
blank_page 0 нет кнопки для возврата
1 перенаправления нет, обработка JavaScript оповещений
2 перенаправление в новой вкладке

В случае если отправлены только параметры merchant_fail_url / merchant_success_url / merchant_return_url при нажатии на кнопку Вернуться на сайт перенаправления не происходит, доступна обработка JavaScript оповещений.

Если merchant_success_enabled и merchant_fail_enabled не переданы — возврат происходит в режиме "2".

Если Payment Page открыт в модальном окне:
merchant_success_redirect_mode merchant_fail_redirect_mode merchant_return_redirect_mode merchant_success_enabled merchant_fail_enabled merchant_return_enabled Ожидаемый результат
iframe 0 нет кнопки для возврата
1 перенаправления нет, модальное окно закрывается при нажатии на кнопку
2 перенаправление в iframe
parent_page 0 нет кнопки для возврата
1 перенаправления нет, модальное окно закрывается при нажатии на кнопку
2 перенаправление всей страницы
blank_page 0 нет кнопки для возврата
1 перенаправления нет, модальное окно закрывается при нажатии на кнопку
2 перенаправление в новой вкладке

В случае если отправлены только параметры merchant_fail_url / merchant_success_url / merchant_return_url при нажатии на кнопку Вернуться на сайт происходит закрытие модальной страницы.

Если merchant_success_enabled и merchant_fail_enabled не переданы — возврат происходит в режиме "2".

Если Payment Page открыт в отдельной вкладке:
merchant_success_redirect_mode merchant_fail_redirect_mode merchant_return_redirect_mode merchant_success_enabled merchant_fail_enabled merchant_return_enabled Ожидаемый результат
iframe 0 нет кнопки для возврата
1 перенаправление всей страницы
2 перенаправление всей страницы
parent_page 0 нет кнопки для возврата
1 перенаправление всей страницы
2 перенаправление всей страницы
blank_page 0 нет кнопки для возврата
1 перенаправление в новой вкладке
2 перенаправление в новой вкладке

В случае если отправлены только параметры merchant_fail_url / merchant_success_url / merchant_return_url при нажатии на кнопку Вернуться на сайт происходит перенаправление всей страницы.

Если merchant_success_enabled и merchant_fail_enabled не переданы — возврат происходит в режиме "2".