No momento, esta página não está disponível em português
Issuin icon

Manage legal entities

View and manage your users' legal entity resources.

View legal entity details

To view the legal entity details of an account holder in your Customer Area, you can search for the account holder associated to the legal entity. As an alternative:

  1. In the navigation menu, select the merchant account linked to your balance platform.

  2. Select Platforms > Accounts & balances > Account holders.

  3. In the account holder table, select an Account holder ID.

  4. In the Account holder details page, select Overview > Legal entity.

The Legal entity details of the main legal entity are shown. You can view bank account information for the main legal entity under Transfer instruments.

If the legal entity is an organization, the page also shows details about the associated legal entities under Entity associations.

If the legal entity is an individual or a sole proprietorship, their personally identifiable information (PII) is redacted. Personally identifiable information includes their:

  • Name
  • Address (except for the country/region)
  • Date of birth
  • Email address
  • Phone number
  • IBAN or bank account number

To view this information in its unredacted state, you must have either the View account holders PII data user role.

Change legal entity type

Users sometimes sign up with an incorrect legal entity type. To change the legal entity type to the correct one, you can:

  • API-only onboarding: make a PATCH /legalEntities/{id} request to update the legal entity type and then provide additional required information.
  • Hosted onboarding: let your user change their legal entity type and provide additional required information in the UI.

All verification checks are run again after the legal entity type is changed.

You can only change the type of the main legal entity. If the type of an associated legal entity is incorrect, you need to create a new legal entity.

Retained information

When you change the legal entity type, the following information is retained:

  • The legal entity id
  • Transfer instruments
  • Bank statement details
  • Proof of industry
  • Processed amounts
  • Business lines

When changing between an individual and an organization legal entity, the following information is migrated:

  • The country is migrated from the individual residentialAddress to the organization registeredAddress.
  • The individual name is migrated to the organization legalName.

When changing between an organization and an individual legal entity, the following information is migrated:

  • The country is migrated from the organization registeredAddress to the individual residentialAddress.
  • The organization legalName is migrated to the individual name.

Your user can change their legal entity type by selecting a different type of bank account to receive their payouts.

The example below shows how your user can change their legal entity from an organization to an individual.

In the Personal details section, your user needs to provide the account holder for the bank account to receive payouts.

If they select a personal bank account, they are prompted to continue onboarding as an individual legal entity.

Note that when the user changes the legal entity type from organization to individual, the First name and Last name are left empty in the UI for the user to complete.

To change a legal entity from an organization to a sole proprietorship, your user should first follow the above flow to change the type from organization to individual. If they then select My sole trader name for the bank account, they are prompted to continue onboarding as a sole proprietorship legal entity.

See also