.. meta::
   :description: API скоринга /api/scoring/v1/status SBC: запрос статуса и результата ранее инициированного скоринга заёмщика.

.. _api_mfo_v1_scoring_status:

/api/scoring/v1/status
######################


.. role:: ex

.. role:: code

Введение
^^^^^^^^^^^^

| Запрос статуса скоринга карты инициируется через :code:`HTTPS GET` запрос по :ref:`URL<api_url_mfo_v1_scoring_status>` с указанными ниже :ref:`параметрами<api_parameters_mfo_v1_scoring_status>`. Для аутентификации используется :ref:`OAuth HMAC-SHA1<HMAC-SHA1>`.

.. _api_url_mfo_v1_scoring_status:

API URL
^^^^^^^^

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

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

   * - Интеграционная среда
     - Производственная среда
   * - :ex:`https://sandbox.sbctech.ru/paynet/api/scoring/v1/status/{endpoint_id}`
     - :ex:`https://gate.sbctech.ru/paynet/api/scoring/v1/status/{endpoint_id}`

.. _api_parameters_mfo_v1_scoring_status:

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

.. note::
  | Запрос должен иметь content-type=application/x-www-form-urlencoded и :ref:`заголовки авторизации<HMAC-SHA1>`.

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

   * - Параметры запроса статуса
     - Описание
   * - :code:`client_orderid`
     - Идентификатор заказа Присоединяющейся Стороны для транзакции, статус которой запрашивается.
   * - :code:`orderid`
     - Идентификатор заказа, присвоенный SBC.

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

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

   * - Название параметра
     - Описание
   * - :code:`type`
     - Тип ответа. Может быть :ex:`status-response`.
   * - :code:`serial-number`
     - Уникальный номер, присваиваемый сервером SBC конкретному запросу от Присоединяющейся стороны.
   * - :code:`status`
     - Код статуса первоначальной транзакции. Может быть :ex:`approved`, :ex:`declined`, :ex:`processing`, :ex:`error` или :ex:`filtered`. Если тип равен :ex:`filtered`, это означает, что транзакция была сочтена мошеннической сервером SBC.
   * - :code:`client-order-id`
     - Идентификатор заказа клиента
   * - :code:`paynet-order-id`
     - Идентификатор заказа, присвоенный SBC.
   * - :code:`card-ref-id`
     - Идентификатор, сгенерированный card-ref.
   * - :code:`bin`
     - Первые 6 цифр карты.
   * - :code:`last-four-digits`
     - Последние 4 цифры карты.
   * - :code:`bank-name`
     - Название банка-эмитента карты.
   * - :code:`scoring-service-request-id`
     - Идентификатор запроса сервиса скоринга.
   * - :code:`scoring-service-response-id`
     - Идентификатор ответа сервиса скоринга.
   * - :code:`score1`
     - Скоринг-балл 1.
   * - :code:`score2`
     - Скоринг-балл 2.
   * - :code:`score3`
     - Скоринг-балл 3.
   * - :code:`scoring-service-response`
     - Текстовый ответ сервиса скоринга.
   * - :code:`error-message`
     - Если статус:ex:`declined`,:ex:`error` или:ex:`filtered`, этот параметр содержит причину отклонения.
   * - :code:`error-code`
     - Код ошибки для транзакций в статусе:ex:`declined`,:ex:`error`,:ex:`filtered`.

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

.. highlight:: text

::

    GET /paynet/api/scoring/v1/status/2404?client-order-id=score123&orderid=9550
    Parameters:
       client-order-id: score123
       orderid: 9550
    Headers:
       accept-encoding: gzip,deflate
       authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="PSWvnfwMDH",oauth_signature_method="HMAC-SHA1",oauth_signature="lYpN%2BRi4u3tcCXJknQGVxlIGKQk%3D"

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

.. highlight:: text

::

    HTTP/2 200 OK
    Date: Mon, 01 Dec 2020 11:47:18 GMT

    type=scoring-status-response
    &serial-number=00000000-0000-0000-0000-00010b87dbc2
    &status=approved
    &client-order-id=score123
    &paynet-order-id=9550
    &bin=555555
    &last-four-digits=4444
    &bank-name=WORLDBANK
    &scoring-service-request-id=9550
    &scoring-service-response=<?xml version="1.0" encoding="UTF-8" standalone="yes"?><response><id>9550</id><cd>0</cd><results><result><name>score</name><value>0.5820386168936834</value></result></results></response>


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

.. highlight:: text

::

    HTTP/2 403 Forbidden
    Date: Mon, 01 Dec 2020 11:47:18 GMT

    type=error
    &serial-number=00000000-0000-0000-0000-000003da9cb1
    &error-message=Forbidden
    &error-code=-1

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

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