.. meta::
   :description: Верификация карты с мобильного устройства в Payneteasy: проверка личности держателя карты из мобильного приложения через сценарий верификации с поддержкой 3DS перед сохранением карты.

.. _mobile_device_card_verification:

Верификация карты с мобильного устройства
===============================


.. role:: ex

.. role:: code

Введение
------------

| Верификация карты с мобильного устройства позволяет :code:`Consumer` проще совершать transfer- и sale-транзакции с помощью единого процесса верификации. В ходе процесса карта проверяется со стороны :code:`Payneteasy` и сопоставляется со ссылкой на :code:`сервере Присоединяющейся Стороны`. Это позволяет :code:`Consumer` избежать ввода данных карты при каждой transfer- или sale-транзакции. Интеграция основана на HTTP POST запросах/ответах с данными в формате JSON.
|
| Значение терминов см. в :ref:`Глоссарии<glossary>`.

Сценарий верификации карты с мобильного устройства
------------------------------------

.. uml::

    @startuml
    autonumber
    title Мобильное Устройство - \nВерификация карты 3DS
    skinparam ParticipantPadding 70
    participant "Клиент" as client
    participant "Мобильное приложение" as mobile
    participant "Сервер \nПрисоединяющейся Стороны" as party
    participant "Payneteasy" as company
    client <-> mobile: Аутентификация
    mobile -> party: Запрос \nтокена доступа
    mobile <-- party: Ответ с \nтокеном доступа
    note right
    accessToken
    end note
    mobile -> party: Запрос \nинициации верификации
    mobile <-- party: Ответ \nинициации верификации
    mobile -> company: Обработка \nвалидации запроса
    mobile <-- company: Обработка \nвалидации ответа
    note right
    session token
    end note
    party <- company : Проверка \nзапроса верификации
    party --> company : Проверка \nответа верификации
    company -> company: Начало обработки
    mobile -> company: Верификация \nзапроса статуса
    note left
    session token
    end note
    mobile <-- company: Верификация \nответа со статусом
    note right
    state = PROCESSING
    end note
    mobile -> mobile: Открытие браузера и \nпредоставлние redirectUrl \nдля перенаправления \nна страницу 3DS
    activate mobile
    client <- mobile: Предоставление \nredirectUrl
    client -> mobile: Предоставлние \nдержателем карты \nданных аутентификации
    mobile -> company: Обновление статуса 3DS
    company --> mobile: Запрос на закрытие браузера
    destroy mobile
    company -> company: Обработка верификации
    party <- company: Запрос уведомления \nверификации сравнения \nкарты
    note right
    server card id
    end note
    party --> company: Ответ уведомления \nверификации сравнения \nкарты
    mobile -> company: Запрос статуса верификации
    note left
    session token
    end note
    mobile <-- company: Ответ статуса верификации
    note right
    state = APPROVED|DECLINED
    end note
    party <- company: Запрос обратного вызова \nс финальным статусом
    party --> company: Ответ обратного вызова \nс финальным статусом
    @enduml

| (1,2,3) Для выполнения аутентификации Consumer в приложении Присоединяющейся Стороны Присоединяющаяся Сторона может использовать любой подходящий ей метод. В результате сервер Присоединяющейся Стороны генерирует {accessToken} и предоставляет его приложению Присоединяющейся Стороны. Этот параметр будет использоваться для начала и продолжения сессии.
| (4,5) Для инициирования верификации карты приложение Присоединяющейся Стороны отправляет :ex:`{accessToken}` с другими параметрами устройства на сервер Присоединяющейся Стороны. Для имплементации запроса инициирования верификации см. :ref:`Initiate verification<api_initiate_verification>`.
| (6,7) Приложение Присоединяющейся Стороны отправляет данные держателя карты, устройства, сессии и другие параметры напрямую в Payneteasy для проверки валидности карты. Для имплементации запроса выполнения валидации см. :ref:`Perform validation<api_perform_validation>`.
| (8,9) Проверка верификации используется в целях безопасности и позволяет Payneteasy сравнить данные, отправленные приложением Присоединяющейся Стороны, с данными, хранящимися на сервере Присоединяющейся Стороны. Для имплементации запроса проверки верификации см. :ref:`Check verification<api_check_verification>`.
| (11,12,21,22) Запрос статуса верификации выполняется приложением Присоединяющейся Стороны в Payneteasy для получения статуса транзакции верификации. Для имплементации запроса статуса верификации см. :ref:`Verification status<api_verification_status>`.
| (19,20) Payneteasy отправляет запрос уведомления о сопоставлении карты верификации на сервер/прокси Присоединяющейся Стороны с созданной на своей стороне ссылкой на карту - :ex:`{serverCardId}`. Для имплементации запроса уведомления о сопоставлении карты верификации см. :ref:`Verification card mapping notification<api_verification_card_mapping_notification>`.
| (23,24) Если callback URL Присоединяющейся Стороны указан на уровне endpoint, Платёжный Шлюз отправляет сообщение на этот callback URL при достижении транзакцией финального статуса, независимо от того, является ли результат :ex:`approved`, :ex:`declined` или имеет другой :ref:`финальный статус<status_list>`. Подробнее см. в :ref:`Callbacks<merchant_callbacks>`.

.. ifconfig:: "doc.payneteasy.com" in site_link

   ----

   .. admonition:: See also
      :class: related-cross-link

      `Multichannel integration including mPOS and SDK → <https://payneteasy.com/solutions/channels>`_

.. ifconfig:: "doc.payneteasy.ru" in site_link

   ----

   .. admonition:: См. также
      :class: related-cross-link

      `mPOS & POS SDK — приём платежей через терминалы → <https://payneteasy.ru/solutions/mpos>`_