.. meta::
   :description: Финальное перенаправление в формах интеграций Payneteasy: как шлюз перенаправляет клиента на URL возврата торговца с окончательным результатом транзакции.

.. _final_redirect:

Финальное Перенаправление
##########################################


.. role:: ex

.. role:: code

Параметры Финального Перенаправления
==================================================

Финальное перенаправление на сайт торговца (представленного Присоединяющейся Стороной) осуществляется, когда Плательщик завершает процесс оплаты. Финальное перенаправление инициируется внутри браузера клиента с помощью метода HTTP POST.

.. list-table::
   :widths: 25, 75
   :header-rows: 1
   :class: longtable

   * - Название параметра перенаправления
     - Описание
   * - :code:`status`
     - Подробности см. в :ref:`status_list`.
   * - :code:`orderid`
     - Идентификатор заказа, присвоенный заказу gate.payneteasy.ru.
   * - :code:`merchant_order`
     - Идентификатор заказа Присоединяющейся Стороны.
   * - :code:`client_orderid`
     - Идентификатор заказа Присоединяющейся Стороны.
   * - :code:`error_message`
     - Для транзакций в статусе :ex:`declined` или :ex:`error`, этот параметр будет содержать причину отклонения или сведения об ошибке.
   * - :code:`control`
     - Контрольная сумма, подтверждающая, что gate.payneteasy.ru (а не мошенник) инициирует запрос. Представляет собой хеш :ex:`SHA-1` от конкатенации параметров :ex:`status` + :ex:`orderid` + :ex:`client_orderid` + :ex:`merchant-control`.
   * - :code:`descriptor`
     - Дескриптор шлюза.
   * - :code:`processor-tx-id`
     - Идентификатор транзакции, присвоенный Эквайером.
   * - :code:`amount`
     - Фактическая сумма транзакции.
   * - :code:`bin`
     - Банковский BIN кредитной карты клиента.
   * - :code:`type`
     - Тип ответа.
   * - :code:`card-type`
     - 	Тип карты плательщика.
   * - :code:`phone`
     - Номер телефона плательщика.
   * - :code:`last-four-digits`
     - 	Последние четыре цифры карты плательщика.
   * - :code:`card-holder-name`
     - Имя на карте плательщика.
   * - :code:`error_code`
     - Код ошибки.

Присоединяющейся Стороне не рекомендуется использовать перенаправление плательщика как основной источник информации о статусе транзакции. Если Присоединяющейся Стороной был передан параметр :ex:`server_callback_url` в инициирующем запросе на проведение транзакции, Платёжный Шлюз вызовет этот URL при достижении транзакцией финального статуса. Присоединяющаяся Сторона может использовать этот URL для произвольной обработки информации о транзакции, например, для сбора информации о транзакциях в базу данных. Параметры, отправляемые на URL обратного вызова описаны в разделе :ref:`Обратный вызов<merchant_callbacks>`. 

Пример запроса финального перенаправления
=======================================================

Платёжный Шлюз совершает перенаправление методом POST на адрес :code:`https://connectingparty.com/pay/redirect?token=some_token` с параметрами в формате x-www-form-urlencoded format:

.. code-block:: bash

   error_message=null
   &processor-tx-id=PNTEST-1788082
   &amount=100.00
   &merchant_order=test
   &orderid=1788082
   &client_orderid=test
   &bin=444455
   &control=854f38715ee6bf43fa18e3ca202985a06e0ae755
   &gate-partial-reversal=enabled
   &descriptor=DEMO1
   &gate-partial-capture=enabled
   &type=sale
   &card-type=VISA
   &phone=%2B31201112233
   &last-four-digits=1111
   &card-holder-name=TEST+HOLDER
   &status=approved