.. _/api/3ds/v1/upload-cres-result/:

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

.. contents::
  :local:

.. role:: ex

.. role:: code

After receiving :code:`cRes` value to :ex:`notificationURL`, upload the results using :code:`HTTP POST` request to :ref:`URLs</api/3ds/v1/upload-cres-result/_url>` and the :ref:`parameters</api/3ds/v1/upload-cres-result/_parameters>` specified below.

.. _/api/3ds/v1/upload-cres-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-cres-result/ENDPOINTID`
     - :ex:`https://gate.payneteasy.com/paynet/api/3ds/v1/upload-cres-result/ENDPOINTID`
   * - :ex:`https://sandbox.payneteasy.com/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID`
     - :ex:`https://gate.payneteasy.com/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID`

.. _/api/3ds/v1/upload-cres-result/_parameters:

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

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

   * - Parameter Name
     - Max Length
     - Description
   * - :code:`cRes`
     - 4096
     - The CRes message is the ACS response to the CReq message. It indicates the result of the Cardholder 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 :code:`error` status.

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

.. code-block:: guess

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

  cres=ewogICJtZXNzYWdlVHlwZSIgICAgOiAiQ1JlcyIsCiAgIm1lc3NhZ2VWZXJzaW9uIiA6ICIyLjEuMCIsCgogICJ0aHJlZURTU2VydmVyVHJhbnNJRCIgOiAiZDAwYTdhZmUtMmE0ZC00NmI0LThmN2YtZjRlZmFkZjE0MmIzIiwKICAiYWNzVHJhbnNJRCIgICAgICAgICAgIDogImFjYWMwMzAxLTVlMWItNDk3Yy04NzA0LTZkNTU5NTc1YTRmZSIsCgogICJjaGFsbGVuZ2VDb21wbGV0aW9uSW5kIiA6ICJZIiwKICAidHJhbnNTdGF0dXMiICAgICAgICAgICAgOiAiWSIKfQ==
  &orderid=6684126
  &control=d0539beedb9a7266547530c8d2027f2b14503a61
  &login=test1
  &client-order-id=1e21f041-871d-4642-a6d9-968457df47a0

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-000002d6202d
  &merchant-order-id=1e21f041-871d-4642-a6d9-968457df47a0
  &paynet-order-id=6684126

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