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.
- Factors — Insights data with additional scoring of the order input.
For more information, see MaxMind’s Compare the minFraud Services documentation.
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
, andmsn.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:
Error | Description |
---|---|
MAX_REQUESTS_REACHED | You have run out of MinFraud queries on your MaxMind account. Purchase more queries on the MaxMind website. |
INVALID_LICENSE_KEY | The 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_REQUIRED | You have not provided a license key. Configure one at Configuration () > System Settings > Fraud Protection. |
USER_ID_REQUIRED | You have not provided a MaxMind user ID. Configure one at Configuration () > System Settings > Fraud Protection. |
Last modified: September 10, 2024