kyc.failed - Finogates API Documentation

The kyc.failed event is sent when a user’s KYC verification fails due to a system or verification error. This is a rare event and indicates that the KYC process could not be completed successfully.

Example Payload

{
  "event": "kyc.failed",
  "id": "fb081022-a61a-4875-9536-988ac535b85a",
  "data": {
    "user_id": "fb081022-a61a-4875-9536-988ac535b85a",
    "kyc_status": "failed"
  },
  "eventGeneratedTime": 1756721043.214908
}

Data Fields

string

Unique identifier of the user whose KYC verification failed.

string

KYC status. Always failed for this event.

Handling the Event

Use this event to:

Flag the user for manual or automated review
Retry the KYC process if supported
Alert compliance or operations teams
Prevent further automated KYC processing

kyc.applied
kyc.rejected
kyc.completed
kyc.deleted

​Example Payload

​Data Fields

​Handling the Event

​Related Events

Example Payload

Data Fields

Handling the Event

Related Events