Skip to main content
  • 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

StatusDescription
newThe company has been created and KYB has not yet been initiated.
pendingKYB is currently being processed by our KYB provider. This process may take a few days.
passedKYB has passed, unlocking the system’s full functionality.
failedKYB 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": []
        }
      ]
    }
  ]
}