Weavr platform updates

Support for users who operate across multiple corporatesCorporates (Corporate Identity). 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., clearer KYBKYB (Know Your Business). 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. status and KYBKYB (Know Your Business). 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. run information for corporatesCorporates (Corporate Identity). 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., and more.

Users who operate across multiple corporates

An individual can now belong to more than one corporate using a single set of login credentials, as the Root UserRoot userThe individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. of one corporate and/or a non-root userRoot userThe individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. of others, instead of needing a separate, duplicate account per corporate.

Switching access to another corporate doesn't require signing in again: the current access token simply needs to be exchanged for one scoped to another corporate, and a stepped-up (SCASCA (Strong Customer Authentication). Strong Customer Authentication - a two-factor authentication solution required by PSD2 regulations for when end-users are accessing their payment account sensitive information or initiating transactions. SCA requires at least two of the following: something you know (password), something you have (device), or something you are (biometrics).) session carries across the exchange. The result is one seamless sign-in for end users who operate across several CorporatesCorporates (Corporate Identity). 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..

This is a non-breaking change and needs no additional configuration to enable.

See Get an access token and Give a user access to another corporate for the API flows.

Get an access tokenAuthenticate a user and exchange their token for access scoped to another corporate.Read documentation →Give a user access to another corporateAdd an existing user to another corporate and manage their access.Read documentation →

Clearer KYB status and run information

We've simplified how KYBKYB (Know Your Business). 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. status is communicated across the API and webhooks. Instead of reading the effective kybStatus and ongoing ongoingKybStatus fields together, use corporateKybStatus as the single lifecycle status for a corporate's acceptance to use financial services:

• NEW
• PENDING
• APPROVED
• REJECTED
• CLOSED

The deprecated kybStatus maps to the new status as follows:

kybStatus	corporateKybStatus
NOT_STARTED	NEW, unless the corporate has since been closed, then CLOSED
INITIATED or PENDING_REVIEW	PENDING
APPROVED	APPROVED, unless the corporate has since been closed, then CLOSED
REJECTED	REJECTED, unless a new KYBKYB (Know Your Business). 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. run has started, then PENDING

CLOSED now shows when the corporate account is closed, which kybStatus never reported. REJECTED describes the latest outcome, not the corporate's complete KYBKYB (Know Your Business). 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. history.

GET /corporates/kyb returns every KYBKYB (Know Your Business). 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. run in kybRuns[]. Each run has its own ID, identifies whether it is initial onboarding or a KYBKYB (Know Your Business). 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. refresh, and exposes detailed progress including collection, review, resubmission, approval, rejection, and cancellation. This helps you show end customers where they are in the KYBKYB (Know Your Business). 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.

These fields are included in GET /corporates/kyb, the corporate KYBKYB (Know Your Business). 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. status webhook, and the Identity Activated and Identity Deactivated webhooks. Webhook events include the latest run for each regulatory financial institution.

For managed-onboarding programmesProgrammeA programme represents your application within Weavr. Everything you create - Identities, Instruments, Transactions - sits beneath a Programme. When you register as an Embedder, you receive a Programme in the Sandbox and, once approved, one in Production., COLLECTION.READY_TO_START is the new signal that a corporate can begin KYBKYB (Know Your Business). 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.. Until Weavr finishes preparing the case, Start KYBKYB (Know Your Business). 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. returns MANAGED_ONBOARDING_PENDING. When preparation completes, the KYBKYB (Know Your Business). 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. status webhook reports PENDING and COLLECTION.READY_TO_START; Start KYBKYB (Know Your Business). 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. then succeeds.

This is additive and non-breaking. kybStatus, ongoingKybStatus, status, ongoingStatus, and details are deprecated but remain populated. They derive from the same data as the new fields, so the old and new payloads cannot conflict. Existing corporatesCorporates (Corporate Identity). 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. require no migration.

Update your integration to read corporateKybStatus and kybRuns[] when you're ready. See Corporate due diligence and KYB and corporate webhook events for the full flow.

Corporate due diligence and KYBUnderstand the corporate KYB lifecycle and how to start and monitor a KYB run.Read documentation →Corporate webhook eventsHandle corporate KYB status updates and other corporate lifecycle events.Read documentation →

Fix to Managed Account IBAN upgrade

Managed AccountManaged AccountAn account held at a financial institution that can be created and managed through the Weavr platform. Each account has a balance where customers can hold funds. Optionally, an IBAN can be assigned to enable wire transfers to bank accounts outside of Weavr. IBANIBAN (International Bank Account Number). International Bank Account Number - a standardized international bank account identifier. Managed accounts can be assigned an IBAN to enable wire transfers to and from bank accounts outside of Weavr. IBANs are required for EUR accounts and enable SEPA transfers. upgrade no longer returns ALLOCATED when bankAccountDetails are not yet available from async IBANIBAN (International Bank Account Number). International Bank Account Number - a standardized international bank account identifier. Managed accounts can be assigned an IBAN to enable wire transfers to and from bank accounts outside of Weavr. IBANs are required for EUR accounts and enable SEPA transfers. providers.

In line with our existing documentation, the response will be PENDING_ALLOCATION until bank details are ready to use. An account update webhook is sent with state UPDATED, at which point the GET /managed_accounts/{id}/iban endpoint can be called to retrived the ALLOCATED bankAccountDetails.

Assign an IBAN or sort code and account numberUpgrade a Managed Account and retrieve its bank account details when allocation completes.Read documentation →