.. meta::
   :description: Управляйте чёрным, белым и лояльным списками в UI торговца SBC: правила фильтрации по атрибутам транзакций, с импортом и экспортом в CSV-файлы.

.. _merchant_bwl:


Черные, белые и списки лояльности (BWL)
##########################################################################

.. role:: ex

.. role:: code


.. |selecting1| image:: ../_static/images/BWL/selecting1.png
.. |selecting2| image:: ../_static/images/BWL/selecting2.png
.. |synchronizing| image:: ../_static/images/BWL/synchronizing.png
.. |exporting| image:: ../_static/images/BWL/exporting.png
.. |importing| image:: ../_static/images/BWL/importing.png
.. |adding| image:: ../_static/images/BWL/adding.png
.. |synchronizebutton| image:: ../_static/images/BWL/synchronizebutton.png
.. |changebutton| image:: ../_static/images/BWL/changebutton.png
.. |availablelists| image:: ../_static/images/BWL/availablelists.png

Введение
========

| Существует 3 типа списков контроля доступа, которые работают как фильтры проверки в Платежном шлюзе. При обработке транзакции эти списки проверяются и применяется соответствующий фильтр. Экран BWL (Black, White, Loyalty) предназначен для управления белыми, черными и списками лояльности клиентов. Данный экран находится в разделе "Инструменты" -> BWL. Функциональность экрана ускоряет и упрощает процесс помещения атрибутов транзакций в соответствующие списки. Экран также содержит быстрый поиск, который помогает найти точный атрибут транзакции, добавленный ранее.

Чтобы выбрать записи из списка, укажите проект для соответствующих списков из раскрывающегося меню.

.. image:: ../_static/images/BWL/selecting11new.png
       :width: 970
       :align: center


Можно отобразить любую конкретную категорию из определенного списка, щелкнув по ней в списке категорий справа.

.. image:: ../_static/images/BWL/selecting22new.png
       :width: 970
       :align: center

.. note::  Если необходимо выполнить миграцию со старой учётной записи Торговца на новую, попросите менеджера службы поддержки SBC перенести существующие записи BWL.

Чёрные списки
-------------

| Первый фильтр, проверяющий атрибуты транзакции (адрес электронной почты, IP-адрес, адрес и т. д.), — это "Черный список торговца". Управлять этими атрибутами (за исключением BIN) также можно на экране Сведений о заказе. Атрибуты могут иметь следующие статусы:
|

  * атрибут в чёрном списке;
  * атрибут не в чёрном списке;
  * атрибут в чёрном списке SBC.

|

.. image:: ../_static/images/BWL/mb.png
       :width: 350
       :align: center

|
| Если какой-либо атрибут транзакции соответствует атрибуту в списках и соответствующий фильтр включён на уровне проекта, статус транзакции устанавливается в Filtered, а причина фильтрации сохраняется в данных транзакции (см. раздел `Коды ошибок в фильтрах транзакций <https://doc.sbctech.ru/integration/reference/transaction_filters.html>`_ в документации по интеграции).
| При внесении IP-адресов в черный список важно отметить, что большинство клиентов имеют динамический IP-адрес, который может принадлежать разным клиентам одного и того же интернет-провайдера. Пользователи мобильного интернета меняют IP-адрес каждый раз при создании сеанса. Также известно, что клиенты, использующие сервисы сжатия трафика (например, Opera Mobile), заходят через IP-адрес прокси-сервера, предоставляемого сервисами, большинство из которых расположены в Европе. По статистике, если IP-адрес заблокирован более 10 часов, то в 80% случаев фильтрация будет ложноположительной. По этой причине не рекомендуется фильтровать транзакции по IP-адресу без должного контроля. Настоятельно рекомендуется перед добавлением IP-адреса в черный список уточнить у интернет-провайдера, какой максимальный срок блокировки IP-адреса может быть применен. Также важно проверить, присутствует ли данный IP-адрес в каких-либо сторонних антиспамовых системах.

Белые списки
------------

| Белый список позволяет пропустить дополнительные проверки фильтров для транзакций с атрибутами из этого списка. Единственными атрибутами для внесения в белый список являются: номер карты и цифровой отпечаток клиента.
|

.. note:: Если атрибут обнаружен в каком-либо белом списке, то проверки сторонних систем контроля мошенничества также исключаются.


Списки лояльности
-----------------

| Список лояльности предназначен для Торговцев, работающих с определенным кругом клиентов. Базой данных клиента можно управлять на стороне Торговца с сертификацией PCI DSS или на стороне SBC. Система позволяет управлять несколькими типами определенных списков клиентов, такими как имена, адреса электронной почты, мобильные номера и т. д.

| Если какой-либо атрибут транзакции не соответствует атрибуту в списках и соответствующий фильтр включён на уровне проекта, статус транзакции устанавливается в Filtered, а причина фильтрации сохраняется в данных транзакции (см. раздел `Коды ошибок в фильтрах транзакций <https://doc.sbctech.ru/integration/reference/transaction_filters.html>`_ в документации по интеграции).

| Флаг :code:`Однократно` служит для автоматического удаления клиента из списка лояльности после его первой оплаты.

.. image:: ../_static/images/one-time.png
       :width: 720
       :align: center

Добавление новых элементов в BWL
================================

To add new elements, click on the :code:`ADD` button. The type of the added criteria will be automatically identified. Ambiguous criteria type can be manually changed, as presented below. It is also possible to use |changebutton| button to switch between source and destination.


.. image:: ../_static/images/BWL/maddnew.png
       :width: 1000
       :align: center


Загрузка списков
=====================

| In order to add many attributes to one of the lists at once, use :code:`IMPORT` list feature.

.. image:: ../_static/images/BWL/importing.png
       :width: 650
       :align: center

| Например, чтобы добавить номер карты в список, для каждой строки необходимо использовать следующий порядок: (5555514066237247,12,2019) с разделителем ',' между строками.
| Для некоторых списков требуется код страны. Полный список `кодов стран и штатов <https://doc.sbctech.ru/integration/reference/country_codes.html>`_ для загрузки приведен в документации по интеграции.

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

Выгрузка в файл
=====================

| In order to export your data into CSV file, use :code:`EXPORT` to file feature.

.. image:: ../_static/images/BWL/exportingnew.png
       :width: 740
       :align: center

| Данные будут проанализированы в соответствии с заданными параметрами.
| Выгрузка будет содержать номера карты отправителя и номера карты получателя в формате 6+4. Для получения полных данных обратитесь в службу поддержки.

.. image:: ../_static/images/warning.png
       :width: 800
       :align: center


Доступные списки для каждой роли
================================

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

Комментарии
===========

| Присутствует возможность прикрепления комментариев при добавлении новых записей в списки BWL по желанию. 
| При добавлении записей со страницы заказа автоматически будет добавлен комментарий с идентификатором транзакции.
| Для отображения комментария наведите курсор на «…» рядом с записью в списке.

.. image:: ../_static/images/BWL/bwl_comments_new.png
       :width: 1000
       :align: center

Подробности заказа: настройка списков BWL
=========================================

| Атрибуты также можно добавлять и удалять из списков BWL на экране сведений о заказе, как показано ниже:

- Нажмите :code:`ДОБАВИТЬ В СПИСОК` и выберите один из показанных списков:

.. image:: ../_static/images/BWL/addto.png
        :width: 520
        :align: center

- После выбора любого списка выберите критерий, по которому будет занесена в список:

.. image:: ../_static/images/BWL/b.png
        :scale: 80 %
        :align: center

|
| Карта, занесенная в черный список, будет отображаться черным цветом:
|

.. image:: ../_static/images/BWL/black.png
        :scale: 80 %
        :align: center

|
| Карта, внесенная в белый список, будет отображаться зеленым цветом:
|

.. image:: ../_static/images/BWL/white.png
        :scale: 80 %
        :align: center

|
| Карта, внесенная в список лояльности будет отображаться в цвете SBC:
|

.. image:: ../_static/images/BWL/loyal.png
        :scale: 80 %
        :align: center

|

- Одновременно можно выбрать несколько критериев:

|

.. image:: ../_static/images/BWL/criteria.png
        :scale: 80 %
        :align: center

|

- Дополнительные критерии можно добавить через раздел, как показано ниже:

|

.. image:: ../_static/images/BWL/adcriteria.png
        :width: 600
        :align: center

|
| После добавления критериев через раздел, описанный выше, параметры будут иметь цвета в зависимости от выбранного списка:
|

.. image:: ../_static/images/BWL/adcriteria1.png
        :scale: 80 %
        :align: center

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

   ----

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

      `Risk and BWL management → <https://payneteasy.com/payment_technologies/risk_management_and_dispute_management_system>`_

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

   ----

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

      `Управление BWL и рисками → <https://payneteasy.ru/payment_technologies/risk_management_and_dispute_management_system>`_