.. meta::
   :description: API скоринга МФО v2 /api/mfo/v2/scoring-form SBC: запуск скоринга заёмщика через размещённую форму для сбора персональных данных и загрузки документов.

.. _api_mfo_v2_scoring_form:

/api/mfo/v2/scoring-form
########################

.. role:: ex

.. role:: code

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

| Форма Card Scoring инициируется запросом :code:`HTTPS POST` с использованием указанных ниже :ref:`URLs<api_mfo_v2_scoring_form_url>` и :ref:`parameters<api_mfo_v2_scoring_form_parameters>`. Для аутентификации используйте :ref:`OAuth HMAC-SHA1<HMAC-SHA1>`. См. :ref:`statuses`. :ex:`{clientOrderId}` в URL запроса генерируется Присоединяющейся стороной. :ex:`{endpointId}` в URL запроса предоставляется Платёжным Шлюзом.

.. _api_mfo_v2_scoring_form_url:

Form API URLs
^^^^^^^^^^^^^

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

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

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

.. _api_mfo_v2_scoring_form_parameters:

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

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

   * - Название параметра
     - Описание
     - Значение
   * - :code:`redirectUrl`
     - URL, на который клиент будет перенаправлен после завершения запроса карточного скоринга
     - | ``Тип``: String
       | ``Длина``: 128

Ответ parameters
^^^^^^^^^^^^^^^^^^^

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

   * - Название параметра
     - Описание
     - Формат
   * - :code:`error`
     - Ошибка описание (if ошибка occurs).
     - | ``Тип``: String
   * - :code:`orderId`
     - Идентификатор заказа в платёжном шлюзе.
     - | ``Тип``: String
   * - :code:`redirectUrl`
     - URL, на который клиент будет перенаправлен для заполнения данных запроса карточного скоринга.
     - | ``Тип``: String

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

.. highlight:: text

::

    POST /paynet/api/mfo/v2/scoring-form/3772/123 HTTP/2
    Host: sandbox.sbctech.ru
    User-Agent: curl/7.88.1
    Accept: */*
    Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="test_merch",oauth_timestamp="1709030996",oauth_nonce="RrB6HIwPqtg",oauth_signature_method="HMAC-SHA1",oauth_signature="kQsRHApN8f%2FKfM42TjPGHHUK3xE%3D"
    Content-Length: 52
    Content-Type: application/x-www-form-urlencoded

    redirectUrl=http%3A%2F%2Fconnectingparty.com2Fexample2Fredirect2F

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

.. highlight:: text

::

    HTTP/2 200 OK
    Date: Mon, 01 Dec 2020 11:47:18 GMT
    Content-Type: application/json;charset=UTF-8

    {"orderId":2793619,"redirectUrl":"https://sandbox.sbctech.ru/paynet/form/mfo-scoring/init/BB474B5A46346173433239614477534F576533495256794B523362374F65756C73677A5162376C6E365933493D"}

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

.. highlight:: text

::

    HTTP/2 403 Forbidden
    Date: Mon, 01 Dec 2020 11:47:18 GMT
    Content-Type: application;charset=UTF-8

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

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

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