PayPal recently launched an upgrade to the options offered to merchants regarding the amount of fraud risk they are willing to take on. Replacing the Risk Controls that have been in place for the last few years, Fraud Management Filters (FMF) allow you to specify what action to take when certain filters are triggered by a new transaction.
Filters available to all accounts are: the maximum transaction amount you will accept from a customer, which countries you will or will not accept payments from, and whether you will accept payments from Unconfirmed addresses.
Advanced FMF options, available to Website Payment Pro accounts for a monthly fee of $20 plus 5 cents per transaction, offer several more fine-grained controls covering things such as AVS/CVV return values, email address domains, IP address ranges, plus what action to take when a transaction is flagged by PayPal’s internal fraud models.
With the launch of FMF, there are a couple of changes to be aware of with your integrations. Each of the various fraud filters give you three options for the action to take when a filter is triggered. The first two are “accept” or “deny” – but now there is a third option – “review,” which will put the transaction in Pending status and allow you to manually review the transaction to choose if you wish to accept or deny the payment. This step can be done either through the PayPal website, or with the new ManagePendingTransactionStatus API.
So, two things to be aware of if you’re integrating your application to take advantage of the new FMF features – first, update your code to watch for the Pending transaction status. Second, the ACK code on the initial API response for the transaction will be SuccessWithWarning, so update your code to watch for this as well. If both of these conditions are met, you have a transaction that needs manual review (remember, Pending status can also happen when a customer pays with an e-check, so also check the ACK value).
For more details on the steps required to integrate FMF, refer to this page on the PayPal Integration Center