.. _api-3ds-v1-upload-pares-result:

/api/3ds/v1/upload-pares-result
################################

.. contents::
  :local:

.. role:: ex

.. role:: code

Upload PaRes Result
^^^^^^^^^^^^^^^^^^^

After receiving :code:`paRes` value to :ex:`TermUrl`, upload the results using :code:`HTTP POST` request to :ref:`URLs<api-3ds-v1-upload-pares-result_url>` and the :ref:`parameters<api-3ds-v1-upload-pares-result_parameters>` specified below.

.. _api-3ds-v1-upload-pares-result_url:

API URLs
^^^^^^^^

.. note::
    | The path in API URL should not be hardcoded, as it may be changed in future.

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

   * - Integration
     - Production
   * - :ex:`https://sandbox.payneteasy.com/paynet/api/3ds/v1/upload-pares-result/ENDPOINTID`
     - :ex:`https://gate.payneteasy.com/paynet/api/3ds/v1/upload-pares-result/ENDPOINTID`
   * - :ex:`https://sandbox.payneteasy.com/paynet/api/3ds/v1/upload-pares-result/ENDPOINTGROUPID`
     - :ex:`https://gate.payneteasy.com/paynet/api/3ds/v1/upload-pares-result/ENDPOINTGROUPID`


.. _api-3ds-v1-upload-pares-result_parameters:

Request Parameters
^^^^^^^^^^^^^^^^^^

.. list-table::
   :widths: 20, 15, 65
   :header-rows: 1
   :class: longtable

   * - Parameter Name
     - Max Length
     - Description
   * - :code:`paRes`
     - 10240
     - Payer Authentication Response message is returned by the ACS with the result of cardholder payment authentication.
   * - :code:`orderid`
     - 128
     - Order id assigned to the order by Payneteasy.
   * - :code:`login`
     - 20
     - Merchant login name.
   * - :code:`client-order-id`
     - 128
     - Merchant order identifier.
   * - :code:`control`
     - 40
     - | Checksum generated by :ref:`SHA-1<SHA1>`. Control string is represented as concatenation of the following parameters:
       | 1. :ex:`login`
       | 2. :ex:`client_orderid`
       | 3. :ex:`orderid`
       | 4. :ex:`merchant_control` (Control key assigned to Merchant account in the Payneteasy gateway system)

Response Parameters
^^^^^^^^^^^^^^^^^^^

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

   * - Parameter Name
     - Description
   * - :code:`type`
     - The type of response. May be :ex:`async-response`, :ex:`validation-error`, :ex:`error`. If type equals :ex:`validation-error` or :ex:`error`, :code:`error-message` and :code:`error-code` parameters contain error details
   * - :code:`paynet-order-id`
     - Order id assigned to the order by Payneteasy
   * - :code:`merchant-order-id`
     - Merchant order id
   * - :code:`serial-number`
     - Unique number assigned by Payneteasy server to particular request from the Merchant
   * - :code:`error-message`
     - If status is :ex:`error` this parameter contains the reason for decline or error details
   * - :code:`error-code`
     - The error code is case of :ex:`error` status

Request Example
^^^^^^^^^^^^^^^

.. code-block:: guess

  POST /paynet/api/3ds/v1/upload-pares-result/39529 HTTP/1.1
  User-Agent: curl/7.83.0
  Accept: */*
  Content-Length: 2631
  Content-Type: application/x-www-form-urlencoded
  Connection: close

  orderid=6684127
  &md=BB4A517A42736975764E3453302B303144794D754B7A4F697A7953765930784259503870546A79416F6542646F4E4A69534F3243317431726A6352702B68565271
  &paRes=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
  &control=987e7aa6630a862805c65eee02392d7a769cadbe
  &login=test_merchant
  &client-order-id=e690bf9f-0c90-4073-a30a-604d13ae9fb9

Success Response Example
^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: js

  HTTP/1.1 200
  Server: server
  Date: Wed, 17 Nov 2021 11:03:17 GMT
  Content-Type: text/html;charset=utf-8
  Transfer-Encoding: chunked
  Connection: keep-alive
  Keep-Alive: timeout=60
  Vary: Accept-Encoding
  X-XSS-Protection: 1
  Strict-Transport-Security: max-age=31536000
  Content-Language: ru-RU
  P3P: CP="NOI ADM DEV COM NAV OUR STP"
  Content-Encoding: gzip

  type=async-response
  &serial-number=00000000-0000-0000-0000-000002d62036
  &merchant-order-id=e690bf9f-0c90-4073-a30a-604d13ae9fb9
  &paynet-order-id=6684127

Fail Response Example
^^^^^^^^^^^^^^^^^^^^^

.. code-block:: js

  HTTP/1.1 200
  Server: server
  Date: Wed, 17 Nov 2021 11:03:17 GMT
  Content-Type: text/html;charset=utf-8
  Transfer-Encoding: chunked
  Connection: keep-alive
  Keep-Alive: timeout=60
  Vary: Accept-Encoding
  X-XSS-Protection: 1
  Strict-Transport-Security: max-age=31536000
  Content-Language: ru-RU
  P3P: CP="NOI ADM DEV COM NAV OUR STP"
  Content-Encoding: gzip

  type=validation-error
  &serial-number=00000000-0000-0000-0000-000002b36f64
  &merchant-order-id=inv4097763
  &error-message=End+point+with+id+22903+not+found
  &error-code=3

Postman Collection
^^^^^^^^^^^^^^^^^^

.. raw:: html
    :file: ../_static/Postman/Postman_upload3ds.html

Request Builder
^^^^^^^^^^^^^^^

.. raw:: html
      :file: ../_static/examples/upload_PaRes_Result_Debug.html