Company Webhooks Overview

Overview: This webhook reflects changes in a company’s compliance and verification journey. It indicates when KYB review begins, progresses, completes successfully, or requires intervention before the company can fully operate on the platform.

🔹 Company KYB Status Webhook

Events

company.kybstatus.insert — emitted when a company record is first created. The payload returns kycStatus of new, confirming the company was saved successfully.
company.kybstatus.update — emitted whenever the company’s kycStatus value changes after creation.

Statuses

Status	Description
`new`	The company has been created and KYB has not yet been initiated.
`pending`	KYB is currently being processed by our KYB provider. This process may take a few days.
`passed`	KYB has passed, unlocking the system’s full functionality.
`failed`	KYB has failed. Rollfi will reach out with an explanation so any issues can be resolved and KYB can be resubmitted.

Example Payload

{
  "trigger": {
    "eventId": "d2a34d4a-8e7b-4f9f-9d3f-1b9d6d7f6c10",
"eventType": "company.kybstatus.update",
    "eventTimeStamp": "01/06/2026 18:59:16"
  },
  "payload": [
    {
      "Company": [
        {
          "company": "Acme Operations LLC",
          "companyID": "9F3A1C7E-5B22-4D91-8E6A-2C9E47B8A103",
          "businessWebsite": "https://www.acme-operations.com",
          "registration": {
            "isTermsAccepted": true
          },
          "CompanyLocations": [],
          "KYBInformations": [],
          "kycStatus": "pending",
          "BankAccounts": [],
          "PaySchedules": [],
          "StateTaxRegistrations": []
        }
      ]
    }
  ]
}

​🔹 Company KYB Status Webhook

​Events

​Statuses

​Example Payload

🔹 Company KYB Status Webhook

Events

Statuses

Example Payload