Home > Manuals > Tutorials > > Quick Guides



Managing blacklist

Version: V2.10.6528
Added on: 06/04/14
Difficulty:
Time: 45 min
Category: Tutorials

Prerequisite Tutorials

Name Added On Difficulty Time Required Description
How to locate a transaction 09/17/14 15 mins This easy tutorial will give you knowledge about how to locate a transaction using a date range.

Useful Terms

Blacklist    

Managing blacklist

  1. Are you ready?

    In this tutorial we are going to learn how to set up the blacklist rules for direct debit and card transactions.
    When blacklist is enabled, traditionally, the following response codes/messages are received:
    1) E05 (“Bank account is blacklisted”) for direct debit transactions;
    2) E06 (“Card is blacklisted”) for payment card transactions.
    However, you can change the message associated with this code.
    Once a card/account number is marked as blacklisted, the transactions made with this card/account never get submitted/re-submitted to a processor. If the situation requires, this card/account number can be removed from the blacklist.

    To work with the blacklist, proceed as follows:
    1. Set a list of the response codes that are going to be blacklisted.
    2. Set a blacklist policy for a certain type of transactions (direct debit, credit card or both). The policy can be set up at the following levels:
    • at the portfolio level - if the blacklist policy has to be enabled for all the merchants under a particular portfolio; when set, the settings are applied to the new merchants only.
    • at the reseller level - if the blacklist policy has to be enabled for all the merchants under a particular reseller; when set, the settings are applied to the new merchants only.
    • at the merchant level - if the blacklist policy has to be enabled for a particular merchant.
    Note that an overriding mechanism influences the blacklist policy settings within the gateway. To learn more about the overriding mechanism, review this guide.
    3. Сheck which card/account number has been blacklisted.
    4. If you want a particular card/account number to be removed from a blacklist, you can do it manually on the user interface. To make a bulk remove of the blacklisted card/account number, address the issue to the gateway support.

    We will use the following parameters as an example (this value is used for training purposes within this tutorial only):
    Blacklist policy: ACH
    Account #: 4099999992
  2. Firstly, we will set the list of the response codes that are going to be blacklisted.
  3. Log in to the system using your Username and Password and switch to the Administration -> Setup Perspective.

    Note: To learn how to log in and select perspectives, use the prerequisite tutorial Logging in and navigating the application.
  4. Click   Response Codesbutton in the top section of the screen.
  5. Locate   Response Codes  groupbox
  6. Select ACH in Categorydropdown
  7. Click   Findbutton
  8. Locate   Response Codes List  groupbox. You should review the codes in the list and decide which ones you would like to be used for blacklisting if received.
  9. Click   Modify Response Codebutton next to the desired code.
  10. Select Blacklist in Response Typedropdown
  11. Click   Savebutton
  12. Now, we will set a blacklist policy for a certain type of transactions (for example, direct debit).
  13. Switch to the Management -> Merchant perspective.
  14. Select appropriate Merchant or Merchant Account in the top left section of the screen.
  15. Click   Detailsbutton at the top section of the screen.
  16. Choose   Processing  menu item  from the list.
  17. Choose   Settings  menu item  from the list.
  18. Locate   Validation  groupbox
  19. Select ACH in Blacklist Policydropdown
  20. Click   Savebutton
  21. If you want to check which card/account number has been blacklisted, use the Transaction Search form. To learn how to locate a transaction on the Transaction Search form, review this tutorial.
  22. Now we will learn how to remove an account from the blacklist.
  23. Log in to the system using your Username and Password and switch to the Administration -> Setup Perspective.

    Note: To learn how to log in and select perspectives, use the prerequisite tutorial Logging in and navigating the application.
  24. Click   Blacklistbutton in the top right section of the screen.
  25. Locate   Blacklist Search  groupbox
  26. Enter 4099999992 into the Account #textbox. Note that you can also use an Account # (last 4) field to enter only last 4 digits of the account.
  27. Click   Findbutton
  28. Locate   Blacklist  groupbox
  29. Click   Deletebutton next to the retrieved record.
  30. Congratulations, you are done!

    You have learned how to enable transactions blacklist and remove a card/account number from the blacklist, and now you can do it by yourself.

Tags