User Guide

Fraud Management Filters June 23, 2009 37
Customizing Websites to use Fraud Management Filters
Handling FMF Errors in Payment API Operations
...
String strNVPResponse = (String) caller.call( strNVPString);
NVPDecoder decoder = new NVPDecoder();
decoder.decode(strNVPResponse);
String strAck = decoder.get("ACK");
// BEGIN CHANGES FOR FRAUD MANAGEMENT FILTERS
String strErrorCode = decode.get("L_ERRORCODE0");
String strPaymentStatus = decode.get("PAYMENTSTATUS");
if (strAck.equals("SuccessWithWarning") &&
strPaymentStatus.equals("Pending") && strErrorCode.equals("11610"))
{
// [insert code to record this transaction as pending "Review"]
}
else // END CHANGES
if(strAck !=null && !(strAck.equals("Success") ||
strAck.equals("SuccessWithWarning")))
{
session.setAttribute("response",decoder);
response.sendRedirect("APIError.jsp");
return;
}
...
Handling FMF Errors in Payment API Operations
When you use Fraud Management Filters programatically, you must check for errors reported
by a filter in the response to the DoDirectPayment, DoExpressCheckoutPayment,
DoReferenceTransaction, and BillUser API operations. If you enabled reporting of
FMF details in the request to these API operations, the response identifies the filters that
caused a transaction to be pended or denied when these actions occur.
To enable reporting of FMF filter information, set the ReturnFMFDetails flag to 1 (true)
in your request to DoDirectPayment, DoExpressCheckoutPayment,
DoReferenceTransaction, and BillUser. You must explicitly request FMF detail
information or the response will not contain it.
NOTE: Fraud Management Filters operate whether or not you request FMF detail
information.
Regardless of whether you return FMF detail information, you must check for errors.
Specifically, you must check for acknowledgements of Success and SuccessWithWarning
in the response; however, PayPal recommends that you check for all possible
acknowledgement status values. You must check for errors codes 11610 and 11611, depending
on the acknowledgement status:
z If the acknowledgement status is SuccessWithWarning, check for error code 11610,
which indicates that one or more filters caused the transaction to be pended, awaiting your
review