Enabling Transaction Filtering
This page describes how to enable and configure transaction filtering rules for a specific merchant. You only need to do this if you want to configure rules for a specific merchant, in addition to those that you may have configured in Merchant Manager to apply to all of your merchants, and in addition to the rules defined by the merchant themselves in Merchant Administration.
The gateway evaluates all configured rules to determine if the transaction should be accepted, rejected, or marked for review.
To configure rules, you must first enable Transaction Filtering. Simply provide the following field in the Update Merchant Payment Details or Create or Update request:
merchant.service[n]=ENABLE_MSO_CONFIGURED_TRANSACTION_FILTERING
Add a Rule
You can configure the following rules for a merchant:
| Risk Rule | Allows the gateway to... |
|---|---|
| IP Address Range | reject transactions originating from high-risk IP addresses. |
| IP Country | reject transactions originating from IP addresses associated with high-risk countries. |
| Card BIN range | reject transactions based on card BIN ranges. |
| 3-D Secure | reject transactions based on the 3DS authentication result of the payer. |
| CSC | reject transactions based on the CSC response. |
Transaction Filtering Rules API Reference[REST][NVP]
Edit a Rule
To edit a rule, simply provide the updated value for the field in a subsequent Update Merchant Payment Details request.
Delete a Rule
To delete a rule, omit the fields (associated with the rule) from a subsequent Update Merchant Payment Details request. This will overwrite the existing value for those fields with NULL. For example, if you have created a card BIN rule, and you do not provide the fields merchant.transactionFiltering.blockedBinRange[n].start and merchant.transactionFiltering.blockedBinRange[n].end in a subsequent Update Merchant Payment Details request, then the [n] card BIN rule will be deleted.