🎉 Tickety V3 has now been released! Read more →
APIHTTP EventsVerification Events

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

On this page