Corporates

"Identities" are now "Customers"

We used to refer to the representation of your customer in the Weavr system as an identity. We now just call them a customer. The two mean the same thing — you may still see identity in some API fields and older pages.

A corporate represents a legal business entity, such as a limited company, partnership, or sole trader. Unlike a consumer, a corporate is operated by people who act on its behalf rather than by the entity itself. The corporate is registered by a legal representative — typically a director, officer, or someone with power of attorney — who becomes its root userRoot user The 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.. Additional staff can later be invited as authorized usersAuthorized User An individual that has been invited by the root user to manage an identity's instruments and transactions. They are not the legal owner of the identity but can be granted access to perform operations on behalf of the identity. For corporates, card assignees are created as Authorized Users. US-English variant of _Authorised User_. with specific roles to manage cards, funds, or other users on the company's behalf. Use a corporate when your product serves businesses, for example an expense management platform, a business banking app, or a B2B payments solution.

Before a corporate can use any service, the business needs to be registered, its root userRoot user The 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. set up, and the company verified through Know Your Business (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.) checks.

Onboarding a corporate

1. Create a corporate - register the corporate and its root userRoot user The 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. with POST /corporates.
2. Set up the root user - set their password, verify their email, and enroll an authentication factor.
3. Complete KYB - submit due diligence information and documents through our 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. component.

Once 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. is approved, the corporate can hold financial instrumentsInstrument A financial product owned by an Identity. There are two types: Managed Accounts (stored-value accounts that hold balances and can receive wire transfers) and Managed Cards (prepaid cards - virtual or physical - used for purchases). and transact.

Next steps

• Invite additional users to act on the corporate's behalf with specific roles.
• Configure your app's base URL so email verification links resolve back into your app.
• Subscribe to webhook events to receive asynchronous updates on the corporate's 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. status.