Corporate identity webhook events

Corporate identity webhook events inform you of activity on the corporatesCorporates Business entities that can be onboarded as identities on Weavr. Corporate identities represent companies and require Know Your Business (KYB) verification. They can have multiple authorised users and issue cards to card assignees. you have onboarded.

Set up webhooks first

To receive these events, you need to set up a webhook receiver in your app. See the webhooks guide for the full setup.

KYB state updates

We submit KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. details to a third party service provider using the KYB UI component. The third party performs the KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. verification process asynchronously from the details submission process. This webhook event provides you with the latest details on the verification of the corporate identity.

Embedding the KYB flow

For more information on the KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. process, see submit due diligence information to verify the corporate.

The information is 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 webhook includes the following information:

• The corporateId, which is the unique identifier of the corporate identity.
• The status of the KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. verification. Unless the status is APPROVED, the corporate is considered unverified.
• The details–provided only if KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. was not approved. In most cases, you can use this information to fix issues with provided documents and/or details.

Director KYC updates

We submit 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 is triggered whenever there is an update on the status of one of the corporate’s directors.

Director and beneficiary terminology

Directors are represented as beneficiaries of the corporate KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. process. For this webhook, treat beneficiary and director as equivalent.

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

The webhook includes the following information:

• The event, which indicates the changes made to the beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. details.
• The eventDetails–provided only if the beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. 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 beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. that triggered the webhook.