Skip to main content

Buyer Events

Buyer identity event notifications inform you of events that happen and that apply to the buyers you have onboarded. Below are a list of all the buyer identity events we send.

tip

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

KYB State update event​

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. You can start watching this event to receive notifications that provides you with the latest details on the verification of the buyer identity.

EVENTBuyer KYB status updateTry it
info

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

The webhook will be sent to you on the webhook URL configured in your application settings.

The notification includes the following information:

  • The buyerId, which is the unique identifier of the buyer identity.
  • The status of the KYB verification. Unless the status is APPROVED, the buyer 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 update event​

Weavr submits the buyer's directors details to a third party service provider using the Director KYC UI component. The directors' details are verified asynchronously from other processes. You can start watching this event to receive notifications whenever there is an update on the status of one of the buyer's directors.

EVENTBuyer beneficiary status updateTry it

The webhook will be sent to you on the webhook URL configured in your application settings.

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 buyer and the beneficiary that triggered the notification.

Buyer activation / deactivation event​

This webhook notification is triggered whenever there is an update on the activation or deactivation state of one of the buyer's. For a buyer to receive the Activation Webhook, they must complete all the steps in this guide

The webhook will be sent to you on the webhook URL configured in your application settings.

The notification includes the following information:

  • The actionDoneBy, indicates who requested the activation or deactivation request. The Admin will be admin user of the Buyer.
  • The emailAddress – is the email address of who requested the activation or deactivation request.
  • The reasonCode – includes information on why the buyer requested a deactivation request.
EVENTBuyer activationTry it
EVENTBuyer deactivationTry it