MaxMind

MaxMind is a leading provider of IP intelligence and online fraud prevention tools.

Enable MaxMind

To enable MaxMind in WHMCS 8.2 and later:

  • Go to Configuration () > System Settings > Fraud Protection.
  • Click Activate for MaxMind.
  • Check the checkbox to enable MaxMind.
  • Enter your MaxMind user ID and license key. You can find these at My License Key in the MaxMind online portal.
  • Click Save.

To enable MaxMind in WHMCS 8.1 and earlier:

  • Go to Configuration () > System Settings > Fraud Protection.
  • Select MaxMind.
  • Check Enable.
  • Enter your MaxMind user ID and license key. You can find these at My License Key in the MaxMind online portal.
  • Click Save.

Configuration

Fraud Check Service Types

MaxMind offers several levels of fraud check for different costs:

  • Score — An assigned risk score. No other data is available when using this check type. MaxMind recommends this check type to build your own risk modeling.
  • Insights — A range of data to check the potential risk of an order, including the IP address location, the country, and the associated email address.
  • FactorsInsights data with additional scoring of the order input.

MaxMind Fraud Risk Score

If an order receives a risk score that is higher than the value that you enter here, the system will mark it as fraudulent and prevent checkout.

Enter a value that is between 0.01 and 99.9.

  • The default value is 20.
  • Enter 0 to disable checking this option. We do not recommend disabling this option.

For more information, see What is the riskScore?

Reject Free Email Service

Enable this option to check whether the customer’s email domain is a free email provider and, if it is, flag the order as fraudulent.

  • For example, customers who use email addresses from yahoo.com, gmail.com, and msn.com would all be fraudulent.
  • The MaxMind system has currently categorized more than 31,000 free email domain providers from around the world.

Reject Country Mismatch

Enable this option to mark an order as fraudulent if the client’s billing address is significantly different from the location of their IP address.

Reject Anonymous Networks

Enable this option to mark an order as fraudulent if the client placed the order using an anonymous network like a proxy or VPN.

Reject High Risk Country

Enable this option to mark an order as fraudulent if the transaction’s billing address or IP address are in a country that MaxMind has flagged as high risk.

Custom Rules

You can create additional custom rules in your MaxMind account.

For more information, see MaxMind’s Custom Rules Documentation.

Common Errors

You may see the following common errors while using MaxMind:

ErrorDescription
MAX_REQUESTS_REACHEDYou have run out of MinFraud queries on your MaxMind account. Purchase more queries on the MaxMind website.
INVALID_LICENSE_KEYThe license key in your settings is incorrect or it is not valid for the service that you are attempting to access. Verify your license key at Configuration () > System Settings > Fraud Protection. If the license key is correct, contact MaxMind for assistance.
LICENSE_REQUIREDYou have not provided a license key. Configure one at Configuration () > System Settings > Fraud Protection.
USER_ID_REQUIREDYou have not provided a MaxMind user ID. Configure one at Configuration () > System Settings > Fraud Protection.

Last modified: May 28, 2024