.. _merchant_bwl: Black, White And Loyalty Lists ########################################################################## .. toctree:: :maxdepth: 1 .. contents:: :local: .. 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 .. |importbutton| image:: ../_static/images/BWL/importbuttonnew.png .. |exportbutton| image:: ../_static/images/BWL/exportbuttonnew.png .. |addbutton| image:: ../_static/images/BWL/addbuttonnew.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 Overview ======== | There are 3 types of access control lists, which work as filter checks in Payment Gateway. Lists are being checked while processing the transaction when the respective filter gets applied. BWL screen is designed to manage white, black and loyalty customer lists. This screen is located in "Tools" -> "Black & White lists". It makes the process of putting the transactions' attributes to respective lists faster and easier. It also has quick search which helps to find the exact transaction attribute added previously. In order to select entries from list, specify project for corresponding lists from dropdown menu. .. image:: ../_static/images/BWL/selecting11new.png :width: 970 :align: center It is possible to show any specific category from a certain list by clicking it in Category list to the right. .. image:: ../_static/images/BWL/selecting22new.png :width: 970 :align: center .. note:: If it is required to migrate from old merchant account to new account, ask Payneteasy support manager to migrate existing BWL entries. Black Lists ------------- | The first filter checking transaction attributes (email, IP, address, etc) is "Merchant black list". It is possible to manage these attributes (excluding BIN) from the Order details screen. The attributes can have the following statuses: | * attribute is in black list * attribute is not in black list * attribute is in Payneteasy black list | .. image:: ../_static/images/BWL/mb.png :width: 350 :align: center | | If any transaction attribute matches attribute in the lists and respective filter is enabled at the Project's level, the transaction status is set to Filtered and the reason for filtering is saved in the transaction data (see `Error Codes in Transaction Filters `_ section in integration documentation). | For blacklisting IP addresses, it is important to note that most customers have dynamic IP which can be possessed by different customers of the same Internet provider. Mobile Internet users change IP address each time a session is created. It is also known that customers using traffic compression services (e.g. Opera Mobile) come via IP address of the proxy server provided by the service, most of which are located in Europe. According to statistics, if IP address is denied for more than 10 hours, the filtering will be in 80% cases false positive. This is why it is not recommended to filter transactions by IP without proper control. It is highly recommended prior to adding IP address into the black list to check with the Internet provider what maximal period of IP address denial can be applied. It is also important to check if the given IP address is in any third-party anti-spam systems. White Lists ------------ | White list allows to skip additional filter checks for transactions with attributes in this list. The only attributes for whitelisting are: a card number and a customer DNA. | .. note:: If the attribute is found in any white list the third-party fraud control systems' checks are excluded either. Loyalty Lists ----------------- | Loyalty list is designed for merchants who work with the predefined set of customers. Database with customers can be managed on merchant side with PCI DSS certification, or on Payneteasy side. The system allows to manage the following several types of predefined clients lists such as names, emails, phones and etc. | If any transaction attribute does not match attribute in the lists and respective filter is enabled at the Project's level, the transaction status is set to Filtered and the reason for filtering is saved in the transaction data (see `Error Codes in Transaction Filters `_ section in integration documentation). | :code:`One-time` box can be checked for automatic removal of customer from loyalty list after their first payment. .. image:: ../_static/images/one-time.png :width: 720 :align: center Adding New Elements To BWL ================================ To add new elements, click on the |addbutton| 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 Importing Lists ===================== | In order to add many attributes to one of the lists at once, use |importbutton| import list feature. .. image:: ../_static/images/BWL/importing.png :width: 650 :align: center | For example, in order to add card number to list, the following order should be used for every line: (5555514066237247,12,2019) with ',' delimiter between lines. | Some lists require a country code. Full list of country and state codes for lists upload is provided in integration documentation: `country codes `_. .. note:: In case of disconnect or other technical problems during the process, contact technical support. Exporting To File ===================== | In order to export your data into CSV file, use |exportbutton| export to file feature. .. image:: ../_static/images/BWL/exportingnew.png :width: 740 :align: center | The data will be parsed according to set parameters. | Source card number and Destination card number export will be in 6+4 format. For complete data, please contact the support service. .. image:: ../_static/images/warning.png :width: 800 :align: center Available Lists For Every Role ================================ .. raw:: html :file: ../_static/examples/merchant_bwl_table.html Comments =========== | When adding new records to the BWL lists, optionally, comments can be attached. | When adding records from order page, automatically comment will be added with transaction id. | In order to display comment, point a cursor on «…» next to record in the list. .. image:: ../_static/images/BWL/bwl_comments_new.png :width: 1000 :align: center Order Details: Configuring BWL Lists ========================================= | The attributes can also be added and removed from BWL on order details screen, as presented below: - Press :code:`ADD TO LIST` and select one of the shown lists: .. image:: ../_static/images/BWL/addto.png :width: 520 :align: center - After selecting any list, select the criterion by which the card will be listed: .. image:: ../_static/images/BWL/b.png :scale: 80 % :align: center | | Blacklisted card will be shown in black colour: | .. image:: ../_static/images/BWL/black.png :scale: 80 % :align: center | | Whitelisted card will be shown in green colour: | .. image:: ../_static/images/BWL/white.png :scale: 80 % :align: center | | Card in loyalty list will be shown in Payneteasy colour: | .. image:: ../_static/images/BWL/loyal.png :scale: 80 % :align: center | - Several criteria can be chosen at the same time: | .. image:: ../_static/images/BWL/criteria.png :scale: 80 % :align: center | - Additional criteria can be added via section as shown below: | .. image:: ../_static/images/BWL/adcriteria.png :width: 600 :align: center | | After adding criteria via section described above, parameters will have colours depending on the selected list: | .. image:: ../_static/images/BWL/adcriteria1.png :scale: 80 % :align: center