IP Analysis Warnings and Errors
Our IP Analysis process includes a series of automated checks to verify the authenticity of a user's location based on their IP address and device information. This page outlines the potential warnings and errors you might encounter during the IP analysis process.
Automatic Decline Conditions
The following conditions can result in an automatic decline depending on your application settings:
PRIVATE_NETWORK_DETECTED- The user is accessing through a VPN, proxy, or Tor networkCOUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP- The user's IP location doesn't match their document location
Configurable Verification Settings
Applications can configure how the system handles various verification issues by setting actions for different risk categories:
-
VPN/Proxy Detection
- Risks:
PRIVATE_NETWORK_DETECTED - Configurable action: Decline, Review, or Approve
- Risks:
-
Location Discrepancy
- Risks:
COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP - Configurable action: Decline, Review, or Approve
- Risks:
Warning Rejection Tags
These are the IP analysis-related warning tags and their descriptions:
Tag | Description |
|---|---|
PRIVATE_NETWORK_DETECTED | The system detected that the user is attempting to access through a VPN, proxy, or Tor network, potentially to mask their true location. |
COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP | The country indicated in the user's identity or address documents does not match the country associated with their IP address. |
Warning Types
Each risk is assigned a warning type based on your application's configuration settings. Warnings fall into three severity categories:
| Type | Description |
|---|---|
ERROR | Critical issues that resulted in setting the session to `Declined` |
WARNING | Issues that require attention that resulted in setting the session to `In Review` |
INFORMATION | Informational messages that don't affect verification outcome |