Skip to main content

Corporate Identity Notifications

Corporate identity webhook notifications inform you of events that happen and that apply to the corporates you have onboarded.

tip

You can find more information on how to start receiving webhooks here.

KYB State Updates​

Weavr submits KYB details to a third party service provider using the KYB UI component. The third party performs the KYB verification process asynchronously from the details submission process. This webhook notification provides you with the latest details on the verification of the corporate identity.

tip

You can find more information on how to embed and initiate the KYB process here.

The information will be sent to you using the <<WEBHOOK_URL>>/corporates/kyb/watch webhook URL.

info

The <<WEBHOOK_URL>> is the URL configured in your application settings.

The notification includes the following information:

  • The corporateId, which is the unique identifier of the corporate identity.
  • The status of the KYB verification. Unless the status is APPROVED, the corporate is considered unverified.
  • The details – provided only if KYB was not approved. In most cases, you can use this information to fix issues with provided documents and/or details.

Director KYC Updates​

Weavr submits the corporate’s directors details to a third party service provider using the Director KYC UI component. The directors' details are verified asynchronously from other processes. This webhook notification is triggered whenever there is an update on the status of one of the corporate’s directors.

The information will be sent to you using the <<WEBHOOK_URL>>/corporates/kyb/beneficiaries/watch webhook URL.

The notification includes the following information:

  • The event, which indicates the changes made to the beneficiary details.
  • The eventDetails – provided only if the beneficiary details were not approved. In most cases, you can use this information to fix issues with provided documents and/or details.
  • The additionalInformation – includes information on the corporate and the beneficiary that triggered the notification.