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

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

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

Рис. 1. Перенаправление пользователя к сервису банка


В платёжной платформе ecommpay поддерживаются различные способы таких перенаправлений: с открытием страниц сторонних сервисов в объекте iframe, в используемой или в новой вкладке браузера. По умолчанию для каждого метода, с учётом его специфики, в платформе используется один из этих способов. Вместе с тем, при подключении метода в рамках конкретного проекта можно согласовать со специалистами технической поддержки применение иного способа (из числа доступных для этого метода). И наконец, для отдельных платежей можно задавать перенаправление в отдельной вкладке через параметры вызова Payment Page.

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

Если для отдельного платежа требуется указать способ открытия страницы стороннего сервиса в новой вкладке браузера, игнорируя способ, заданный для метода в целом, в запросе необходимо передать булевый параметр force_acs_new_window со значением 1. (Использование этого параметра со значением 0 не влияет на способы перенаправления.)

В следующем примере для проведения оплаты предварительно указан метод Open Banking in Romania, а также задан способ открытия страницы банка Banca Comerciala Romana, поддерживающего оплату этим методом — в отдельной вкладке.

Рис. 2. Пример данных из запроса на открытие Payment Page
{
      payment_id: "X03936", 
      payment_amount: 1000, 
      payment_currency: "EUR", 
      project_id: 123,
      customer_id: "customer1",
      force_payment_method: "online-romanian-banks",
      payment_methods_option:
        {
            "online_romanian_banks":
                {
                    "banks_id": [55941]
                }
        },
      force_acs_new_window: 1,    // способ открытия страницы банка      
      signature: "kUi2x9dKHAVNU0FYldJrxh4...zUCwX6R\/ekpZhkIQg=="
    }
Рис. 3. Пример данных из запроса на открытие Payment Page
{
      payment_id: "X03936", 
      payment_amount: 1000, 
      payment_currency: "EUR",
      project_id: 123,
      customer_id: "customer1",
      force_payment_method: "online-romanian-banks",
      payment_methods_option:
        {
            "online_romanian_banks":
                {
                    "banks_id": [55941]
                }
        },
      force_acs_new_window: 1,    // способ открытия страницы банка      
      signature: "kUi2x9dKHAVNU0FYldJrxh4...zUCwX6R\/ekpZhkIQg=="
    }

Дополнительные материалы

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