UniPay Gateway Documentation

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
Firstly, we will set the list of the response codes that are going to be blacklisted.
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.
Click Response Codesbutton in the top section of the screen.
Locate Response Codes groupbox
Select ACH in Categorydropdown
Click Findbutton
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.
Click Modify Response Codebutton next to the desired code.
Select Blacklist in Response Typedropdown
Click Savebutton
Now, we will set a blacklist policy for a certain type of transactions (for example, direct debit).
Switch to the Management -> Merchant perspective.
Select appropriate Merchant or Merchant Account in the top left section of the screen.
Click Detailsbutton at the top section of the screen.
Choose Processing menu item from the list.
Choose Settings menu item from the list.
Locate Validation groupbox
Select ACH in Blacklist Policydropdown
Click Savebutton
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.
Now we will learn how to remove an account from the blacklist.
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.
Click Blacklistbutton in the top right section of the screen.
Locate Blacklist Search groupbox
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.
Click Findbutton
Locate Blacklist groupbox
Click Deletebutton next to the retrieved record.
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.

Managing blacklist

Prerequisite Tutorials

Useful Terms

Managing blacklist

Tags