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.rejected event is sent when a user’s KYC verification has been rejected after review. This indicates that the user did not meet identity verification requirements and cannot proceed with KYC-restricted actions.

​
Example Payload

{
  "event": "kyc.rejected",
  "id": "7c27c558-9817-4609-84c1-3cd208105f5f",
  "data": {
    "user_id": "7c27c558-9817-4609-84c1-3cd208105f5f",
    "kyc_status": "rejected",
    "kyb_status": "pending"
  },
  "eventGeneratedTime": 1756729948.128641
}

​
Data Fields

​
user_id
string
Unique identifier of the user whose KYC verification was rejected.
​
kyc_status
string
KYC status. Always rejected for this event.
​
kyb_status
string
Current KYB status for the associated business, if applicable.

​
Handling the Event

Use this event to:
  • Block KYC-restricted features and actions
  • Notify the user of the rejection outcome
  • Allow re-submission if supported by your flow
  • Record rejection details for compliance and auditing