kyc.rejected - Finogates API Documentation

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

string

Unique identifier of the user whose KYC verification was rejected.

string

KYC status. Always rejected for this event.

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

kyc.applied
kyc.failed
kyc.completed
kyc.deleted

​Example Payload

​Data Fields

​Handling the Event

​Related Events

Example Payload

Data Fields

Handling the Event

Related Events