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

Общая информация

Для предварительного возвращения пользователей к веб-сервису со страниц платёжной формы используется ссылка, которая задаётся через параметры вызова и отображается как дополнительный элемент формы.

Если при вызове Payment Page задаётся возможность предварительного возвращения из формы, то по умолчанию для этого применяются следующие способы:

• при открытии Payment Page в отдельной вкладке перенаправление выполняется в этой же вкладке;
• при открытии Payment Page в модальном окне это модальное окно закрывается;
• при открытии Payment Page в объекте iframe перенаправление не выполняется, при этом на стороне веб-сервиса доступна обработка интерфейсных событий (подробнее).

Если необходимо задействовать иные способы возвращения, со стороны веб-сервиса можно использовать соответствующие параметры, описанные далее, в разделе Управление доступностью и способами возвращения этой статьи.

Также, применяя возможность предварительного возвращения со страниц платёжной формы, необходимо учитывать следующие особенности:

• Пользователь может вернуться к веб-сервису по отображаемой ссылке только до того, как он подтвердит платёж в платёжной форме (выбрав метод и указав требуемую информацию). После подтверждения платежа ссылка в форме не отображается, поскольку подтверждение ведёт к проведению платежа в платформе и выбранной платёжной системе и это может требовать участия пользователя.
• При ограничении времени работы с платёжной формой (подробнее) обратный отсчёт начинается с момента первичного открытия формы и не останавливается при возвращении пользователя к веб-сервису.

Формат запросов

Адрес для предварительного возвращения к веб-сервису со страниц платёжной формы указывается в запросах на открытие Payment Page в значении параметра merchant_return_url.

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",

   // адрес для предварительного возвращения
   "merchant_return_url": "https://example.com", 

   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
}

Общая информация

Возвращение к веб-сервису со страниц сторонних сервисов, таких как сервисы банков или платёжных систем, возможно только когда это поддерживается с их стороны. Кроме того, в разных сервисах такая функциональность может реализовываться по-разному и может допускать или не допускать обратных возвращений пользователя. С учётом таких особенностей, а также потенциально негативного влияния на проходимость платежей применение возвращений со страниц сторонних сервисов следует предварительно согласовывать с курирующим менеджером ecommpay.

Возвращение к веб-сервису со страниц сторонних сервисов возможно только когда это поддерживается с их стороны. Применение возвращений со страниц сторонних сервисов следует предварительно согласовывать с курирующим менеджером ecommpay.

После согласования и подключения такой возможности адреса для возвращения пользователей можно указывать в запросах на открытие Payment Page. Иначе эти адреса игнорируются.

Формат запросов

Адрес для промежуточного возвращения к веб-сервису со страниц сторонних сервисов указывается в запросах на открытие Payment Page в значении параметра redirect_return_url.

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",

   // адрес для промежуточного возвращения
   "redirect_return_url": "https://your/bank/example.com", 
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
}

Общая информация

При работе с Payment Page итоговое возвращение пользователя к веб-сервису — по результатам проведения платежа — может реализовываться с отображением итоговой страницы платёжной формы, содержащей кнопку для возвращения к веб-сервису по решению пользователя, и автоматически, минуя итоговую страницу платёжной формы и с информированием о результате оплаты сразу на стороне веб-сервиса. При этом автоматическое возвращение не позволяет предоставить пользователю повторные попытки оплаты (подробнее). Также, если итоговое возвращение не актуально, можно отображать пользователю итоговую страницу Payment Page без кнопки для возвращения к веб-сервису.

Адреса и способы итогового возвращения могут задаваться как общие для всех платежей в рамках проекта и частные для отдельных платежей. Для указания общих адресов и способов необходимо использовать интерфейс Dashboard (и инструменты карточки Ссылки для перенаправления в разделе Проекты), для указания частных адресов и способов — параметры запросов на открытие Payment Page (описанные далее, в пункте Формат запросов этого раздела и в разделе Управление доступностью и способами возвращения этой статьи).

Адреса и способы итогового возвращения могут задаваться как общие для всех платежей в рамках проекта (через Dashboard) и как частные для отдельных платежей (через параметры запросов на открытие Payment Page, описанные далее).

По умолчанию в случаях, когда используется итоговое возвращение, для него применяются следующие способы:

• Возвращение по решению пользователя выполняется в используемой вкладке браузера, с закрытием модального окна, если платёжная форма была открыта в нём.
• Автоматическое возвращение выполняется в том же элементе интерфейса, в которым была открыта платёжная форма. Так, если форма была открыта в отдельной вкладке браузера, то возвращение выполняется в этой же вкладке, а если форма была открыта в модальном окне или в объекте iframe, то возвращение выполняется в этом же окне или объекте.

Формат запросов

Для возвращения по решению пользователя можно задавать адреса в значениях следующих параметров:

• merchant_success_url — для возвращения при проведении оплаты,
• merchant_fail_url — для возвращения при отклонении оплаты.

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",

   // адреса для итогового возвращения по решению пользователя
   "merchant_success_url": "https://example.com/complete-redirect?id=success", 
   "merchant_fail_url": "https://example.com/complete-redirect?id=decline", 
   
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."

Для автоматического возвращения можно задавать адреса в значениях следующих параметров:

• redirect_success_url — для возвращения при проведении оплаты,
• redirect_fail_url — для возвращения при отклонении оплаты,
• redirect_tokenize_url — для возвращения при формировании токена платёжных данных в режиме card_tokenize (подробнее).

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": "131970",
   "customer_id": "customer_12",

   // адреса для автоматического итогового возвращения
   "redirect_success_url": "https://example.com/complete-redirect?id=success", 
   "redirect_fail_url": "https://example.com/complete-redirect?id=decline", 
   
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."