Changelog

KYB Status Webhooks

List of webhooks sent to your server

KYB Status Updates

KYB status update webhooks are sent to the path /kyb appended to your Webhook URL configured on the Striga dashboard.

interface KYBStatusWebhook {
  businessId: string;
  status: BusinessVerificationStatus; // Refer to the enum below for a list of statuses
  details?: Array<string>; // Details on why the KYB failed, if it did
  rejectionComments?: {
    userComment: string; // KYB rejection comment for the user from the compliance team
    autoComment: string; // KYB rejection comment generated by the system
  };
  rejectionFinal?: boolean; // If the KYB rejection is final, the business cannot be verified
}
  
enum BusinessVerificationStatus {
  NOT_STARTED = 'NOT_STARTED',
  INITIATED = 'INITIATED', // The "Start KYB" endpoint has been called and the SumSub token has been fetched
  PENDING_REVIEW = 'PENDING_REVIEW', // Documents have been submitted and are pending review
  ON_HOLD = 'ON_HOLD', // Requires manual review from the compliance team
  APPROVED = 'APPROVED', // User approved
  REJECTED = 'REJECTED', // User rejected - Can be final or not
  REJECTED_FINAL = 'REJECTED_FINAL'
}

You can use the above webhook format to inform your user about the current status of KYB and details on why an attempt may be rejected and require re-submission of documents.

In the case that a business is REJECTED, the following details are available via the webhook and the Get KYB Status API.

{
  "businessId": "1182ca55-85d5-4002-b8f9-187c7380bb54",
  "status": "REJECTED",
  "rejectionComments": {
    "moderationComment": "According to the provided documents, the data in the profile is incorrect. Please make amendments to the declared information exactly as they are written in your corporate document: the company’s name is incorrect.",
    "clientComment": "Incorrect company name."
  },
  "details": [
    "COMPANY_INCORRECT_DATA"
  ]
}