Phone Verification Warnings and Errors
Our Phone Verification process includes a series of automated checks to ensure the validity and security of the phone numbers being verified. This page outlines the potential warnings and errors you might encounter during the phone verification process.
Automatic Decline Conditions
The following conditions can result in an automatic decline depending on your application settings:
VERIFICATION_CODE_ATTEMPTS_EXCEEDED
- The user has exceeded the maximum attempts to enter the correct codeHIGH_RISK_PHONE_NUMBER
- The phone number is identified as a high risk number
Configurable Verification Settings
Applications can configure how the system handles various verification issues by setting actions for different risk categories:
-
Number Type
- Risks:
VOIP_NUMBER_DETECTED
- Configurable action: Decline, Review, or Approve
- Risks:
-
Risk Level
- Risks:
DISPOSABLE_NUMBER_DETECTED
- Configurable action: Decline, Review, or Approve
- Risks:
-
Duplicated Number
- Risks:
DUPLICATED_PHONE_NUMBER
- Configurable action: Decline, Review, or Approve
- Risks:
Verification Attempt Limits
The system imposes limits on verification attempts to prevent abuse and maintain security:
- Code Entry Attempts: Maximum 2 attempts to enter the correct verification code
- Code Resend Requests: Maximum 2 requests to resend a verification code within 24 hours
You can customize these attempt limits in your application settings to match your specific security requirements and user experience needs.
Phone Verification Warnings
Tag | Description |
---|---|
VERIFICATION_CODE_ATTEMPTS_EXCEEDED | The user has exceeded the maximum number of attempts to enter the correct verification code. |
HIGH_RISK_PHONE_NUMBER | The phone number is identified as a high risk number. |
DISPOSABLE_NUMBER_DETECTED | The phone number has been identified as temporary or disposable, often used to avoid verification traceability. |
VOIP_NUMBER_DETECTED | The phone number appears to be a Voice over IP (VoIP) number rather than a standard mobile or landline number. |
DUPLICATED_PHONE_NUMBER | The phone number has been identified as a duplicate of a previously verified number. |
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 |