kyb.approved - Finogates API Documentation

The kyb.approved event is sent when a business has successfully passed KYB verification. This indicates the associated business entity is verified and eligible to access KYB-restricted features.

Example Payload

{
  "event": "kyb.approved",
  "id": "e61a0dbd-22b3-4ff2-9da1-bd4097ed273c",
  "data": {
    "user_id": "e61a0dbd-22b3-4ff2-9da1-bd4097ed273c",
    "kyb_status": "approved"
  },
  "eventGeneratedTime": 1756729948.128641
}

Data Fields

string

Unique identifier of the business owner or associated user.

string

Final KYB status. Always approved for this event.

Handling the Event

Use this event to:

Enable business and merchant-level features
Allow payments, settlements, and withdrawals
Update business compliance state
Record KYB approval for auditing and reporting

kyb.rejected
kyb.deleted

​Example Payload

​Data Fields

​Handling the Event

​Related Events

Example Payload

Data Fields

Handling the Event

Related Events