Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.finogates.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
user_id
string
Unique identifier of the user whose KYC verification failed.
​
kyc_status
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