.. _final_redirect:

Final Redirect
##########################################

.. contents::
  :local:

.. role:: ex

.. role:: code

Final Redirect Parameters
==================================================

Final redirect to merchant (represented by Connecting Party) website is performed when Payer ends payment flow. Final redirect is initiated from within Payer's browser using HTTP POST method.

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

   * - Redirect parameter name
     - Description
   * - :code:`status`
     - See :ref:`status_list` for details.
   * - :code:`orderid`
     - Order id assigned to the order by gate.payneteasy.com.
   * - :code:`merchant_order`
     - Connecting Party order id.
   * - :code:`client_orderid`
     - Connecting Party order id.
   * - :code:`error_message`
     - If status is :ex:`declined` or :ex:`error` this parameter contains the reason for decline or error details.
   * - :code:`control`
     - Checksum used to ensure that it is gate.payneteasy.com (and not a fraudster) that initiates the request. This is :ex:`SHA-1` checksum of the concatenation :ex:`status` + :ex:`orderid` + :ex:`client_orderid` + :ex:`merchant-control`.
   * - :code:`descriptor`
     - Gate descriptor.
   * - :code:`processor-tx-id`
     - Acquirer transaction identifier.
   * - :code:`amount`
     - Actual transaction amount.
   * - :code:`bin`
     - Bank BIN of customer credit card number.
   * - :code:`type`
     - The type of response.
   * - :code:`card-type`
     - 	Type of customer credit card.
   * - :code:`phone`
     - Customer phone.
   * - :code:`last-four-digits`
     - 	Last four digits of customer credit card number.
   * - :code:`card-holder-name`
     - Cardholder name.
   * - :code:`error_code`
     - Error Code.

Connecting Party should not use Payer redirect as a main source of information about transaction's final status. If Connecting Party has passed :ex:`server_callback_url` in initial transaction request, Payment Gateway will call this URL. Connecting Party may use it for custom processing of the transaction completion, e.g. to collect sales data in Connecting Party database. The parameters sent to this URL are specified in :ref:`Connecting Party Callbacks<merchant_callbacks>`. 

Final Redirect Request Example
=======================================================

Payment Gateway sends POST redirect to :code:`https://connectingparty.com/pay/redirect?token=some_token` with params in 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