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 userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer must always have one root user.. Additional staff can later be invited as authorized usersAuthorized UserAn individual that has been invited by the root user to manage a customer's instruments and transactions. They are not the legal owner of the customer but can be granted access to perform operations on its behalf. 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 userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer must always have one root user. set up, and the company verified through Know Your Business (KYBKYB (Know Your Business). Know Your Business - the identity verification process for corporate customers. This process allows you to securely verify your business customer's identity. Weavr asks users to submit the information and documentation they need for approval by financial providers.) checks.

Onboarding a corporate

POST/corporatesRegister a corporateCreate the corporate and its root user.View operation →

1. Create a corporate - register the corporate and its root userRoot userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer 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). Know Your Business - the identity verification process for corporate customers. This process allows you to securely verify your business customer's identity. Weavr asks users to submit the information and documentation they need for approval by financial providers. component.

Once KYBKYB (Know Your Business). Know Your Business - the identity verification process for corporate customers. This process allows you to securely verify your business customer's identity. Weavr asks users to submit the information and documentation they need for approval by financial providers. is approved, the corporate can hold financial instrumentsInstrumentA financial product owned by a customer. 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). Know Your Business - the identity verification process for corporate customers. This process allows you to securely verify your business customer's identity. Weavr asks users to submit the information and documentation they need for approval by financial providers. status.