.. meta::
   :description: /api/scoring/v1/score MFO scoring API SBC: инициирует запрос скоринга заёмщика с личными данными и возвращает решение скоринга.

.. _api_mfo_v1_scoring_score:

/api/scoring/v1/score
#####################

.. role:: ex

.. role:: code

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

| Запрос Card scoring инициируется посредством запроса :code:`HTTPS POST` (с кодировкой :ex:`UTF-8`) к указанным ниже :ref:`URL<api_url_mfo_v1_scoring_score>` и :ref:`параметрам<api_parameters_mfo_v1_scoring_score>`. Для аутентификации используйте :ref:`OAuth HMAC-SHA1<HMAC-SHA1>`.

.. _api_url_mfo_v1_scoring_score:

API URL
^^^^^^^^

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

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

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

.. _api_parameters_mfo_v1_scoring_score:

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

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

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

   * - Название параметра
     - Описание
     - Формат
   * - :code:`card-ref-id`
     - Ранее созданный вызовом :ex:`create-card-ref` :ex:`card-ref-id` позволяет найти нужную карту. О создании :ex:`create-card-ref` см. :ref:`/api/v2/create-card-ref/<api-v2-card-ref-id>`. Отправляйте либо :ex:`card-ref-id`, либо :ex:`card-number`, но не оба.
     - N{1-\*}
   * - :code:`card-number`
     - Полный номер карты. Отправьте :ex:`card-number` или :ex:`card-ref-id`, но не оба.
     - N{13-19}
   * - :code:`client-order-id`
     - Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной.
     - N{1-\*}
   * - :code:`first-name`
     - First Name.
     - N{64}
   * - :code:`last-name`
     - Last Name.
     - N{64}
   * - :code:`middle-name`
     - Middle Name.
     - N{64}
   * - :code:`birth-date`
     - Клиент's birth дата.
     - 1982-07-31
   * - :code:`rating`
     - Описание: For example 0000.
     - N{4}
   * - :code:`phone`
     - Клиент's full international phone номер, including страна code.
     - N{11}

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

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

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

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

.. highlight:: text

::

    POST /paynet/api/scoring/v1/score/2404
    Parameters:
       birth-date: 2000-01-01
       card-ref-id: 12345
       client-order-id: score123
       create-card-ref: false
       first-name: John
       last-name: Smith
       middle-name: M
       phone: 19019019191
       rating: 5
    Headers:
       accept: */*
       accept-encoding: gzip,deflate
       authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="OPASWJfawifJHG",oauth_signature_method="HMAC-SHA1", oauth_signature="8FpDccqJGDwppPUnLwokfJl53Mc%3D"
       content-length: 419
       content-type: application/x-www-form-urlencoded


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

.. highlight:: text

::

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

    type=async-response
    &serial-number=00000000-0000-0000-0000-00010b87db96
    &merchant-order-id=score123
    &paynet-order-id=9550
    &end-point-id=2404

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

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