.. meta::
   :description: Конечная точка API Payneteasy /api/3ds/v1/upload-pares-result: отправка ответа аутентификации плательщика (PaRes) от ACS для завершения аутентификации 3DS 1.0.

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

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

.. role:: ex

.. role:: code

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

После получения значения :code:`paRes` на :ex:`TermUrl` загрузите результаты запросом :code:`HTTP POST`, используя указанные ниже :ref:`URL-адреса<api-3ds-v1-upload-pares-result_url>` и :ref:`параметры<api-3ds-v1-upload-pares-result_parameters>`.

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

API URL
^^^^^^^^

.. note::
    | Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.

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

   * - Интеграционная среда
     - Производственная среда
   * - :ex:`https://sandbox.payneteasy.ru/paynet/api/3ds/v1/upload-pares-result/ENDPOINTID`
     - :ex:`https://gate.payneteasy.ru/paynet/api/3ds/v1/upload-pares-result/ENDPOINTID`
   * - :ex:`https://sandbox.payneteasy.ru/paynet/api/3ds/v1/upload-pares-result/ENDPOINTGROUPID`
     - :ex:`https://gate.payneteasy.ru/paynet/api/3ds/v1/upload-pares-result/ENDPOINTGROUPID`


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

Параметры запроса
^^^^^^^^^^^^^^^^^^

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

   * - Название параметра
     - Max Length
     - Описание
   * - :code:`paRes`
     - 10240
     - Сообщение Payer Authentication Response возвращается ACS с результатом аутентификации платежа держателя карты.
   * - :code:`orderid`
     - 128
     - Идентификатор заказа, присвоенный Payneteasy.
   * - :code:`login`
     - 20
     - Логин Присоединяющейся Стороны в Платёжном Шлюзе.
   * - :code:`client-order-id`
     - 128
     - Идентификатор Merchant order.
   * - :code:`control`
     - 40
     - | Контрольная сумма, сгенерированная :ref:`SHA-1<SHA1>`. Строка для подписи представляет собой объединение следующих параметров:
       | 1. Параметр :ex:`login`
       | 2. :ex:`client_orderid`
       | 3. Параметр :ex:`orderid`
       | 4. :ex:`merchant_control` (контрольный ключ, назначенный учётной записи Торговца в системе Платёжного Шлюза Payneteasy)

Параметры ответа
^^^^^^^^^^^^^^^^^^^

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

   * - Название параметра
     - Описание
   * - :code:`type`
     - Тип ответа. Может быть :ex:`async-response`, :ex:`validation-error`, :ex:`error`. Если тип равен :ex:`validation-error` или :ex:`error`, параметры :code:`error-message` и :code:`error-code` содержат сведения об ошибке.
   * - :code:`paynet-order-id`
     - Номер заказа в системе Payneteasy
   * - :code:`merchant-order-id`
     - Торговец order id
   * - :code:`serial-number`
     - Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Торговца
   * - :code:`error-message`
     - Если статус :ex:`error`, этот параметр содержит причину отклонения или сведения об ошибке
   * - :code:`error-code`
     - Код ошибки в случае статуса :ex:`error`

Пример запроса
^^^^^^^^^^^^^^^

.. 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

Пример успешного ответа
^^^^^^^^^^^^^^^^^^^^^^^^

.. 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

Пример неуспешного ответа
^^^^^^^^^^^^^^^^^^^^^

.. 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
^^^^^^^^^^^^^^^^^^

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

Конструктор запросов
^^^^^^^^^^^^^^^

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