Fail
Triggered when a user fails verification
Event Type
"verification.fail"Description
This event is triggered when a user fails the verification process.
Payload Structure
Prop
Type
Example Payload
{
"type": "verification.fail",
"payload": {
"verificationId": "VER-9013",
"userId": "713115896805064856",
"status": "FAILED"
}
}Example Usage
app.post('/webhook', (req, res) => {
const { type, payload } = req.body;
if (type === 'verification.fail') {
console.log(`User ${payload.userId} failed verification`);
console.log(`Verification ID: ${payload.verificationId}`);
// Update user status in your database
await updateUserStatus({
userId: payload.userId,
verified: false,
verificationId: payload.verificationId,
failedAt: new Date(),
});
// Track failed verification attempts
await incrementFailedAttempts(payload.userId);
// Check if user should be kicked/banned
const attempts = await getFailedAttempts(payload.userId);
if (attempts >= 3) {
await handleRepeatedFailures(payload.userId);
}
// Alert moderators if suspicious activity
await checkForSuspiciousActivity(payload.userId, payload.verificationId);
}
res.status(200).send('OK');
});Use Cases
- Track verification failure rates
- Monitor potential bot or spam accounts
- Implement progressive security measures
- Alert moderators of repeated failures
- Analyze verification difficulty and adjust accordingly
- Log failures for security auditing