Event Trigger

This webhook is triggered when the company’s verification status changes to either:

  • Verified
  • Rejected

Webhook Payload

{
  "Live": false,
  "Event": "COMPANY_VERIFICATION_STATUS_CHANGED",
  "Data": {
    "CompanyId": "d549b2af-3752-4844-8d55-475d3462df2a",
    "Status": "Verified"
  }
}

Payload Fields

FieldTypeDescription
LiveboolIt’s true when coming from production environment
EventstringThe event name: always COMPANY_VERIFICATION_STATUS_CHANGED
Data.CompanyIdstringUnique identifier of the company
Data.StatusstringNew status: Verified or Rejected
Data.TimestampstringISO timestamp indicating when the event occurred.

The company status may remain Unverified for up to 24 hours while KYB is being processed.

If you need to manually check a company’s status, use the following endpoint:

GET /company/status

GET https://api.synchpay.com/company/status
Authorization: Bearer <AccessToken>

Response example:

{
  "CompanyId": "d549b2af-3752-4844-8d55-475d3462df2a",
  "Status": "Verified"
}