Skip to main content
An entity is a legal company you do business through. This screen keeps each entity’s registration details, the countries it operates in and its bank accounts, and lets you mark one entity as your default.

​
Where to find it

In the admin, click the Settings gear in the top bar. In the Settings sidebar, under Company, select Entities. To open the screen, your role needs at least View only for Business Entities, in the Commerce card on the role’s Permissions tab. To add entities or change them, including their countries and bank accounts, it needs Full access for Business Entities. Some parts of the screen also need other permissions. See Which other permissions do the entity screens use?.

​
What’s on the screen

The Add Entity button is in the page header. The table lists one row per entity:
  • Entity Name: the entity’s legal company name. A Primary badge marks your default entity.
  • Headquarters: the city and state or province of the registered office. If both are empty, it shows the country code.
  • Countries Served: a flag for each of the entity’s operating countries. After four flags, the rest are counted, for example +2 more.
  • Status: Draft, Active, Inactive or Archived.
Click a row to open the entity. Each row’s three-dot menu has Edit, which also opens the entity, plus one of these:
  • Remove, for a Draft entity that isn’t your default and has no operating countries.
  • Archive, for any other entity that isn’t archived.
  • Restore, for an archived entity.
If you have no entities yet, the table shows Nothing to show.

​
Entity statuses

A new entity starts as Inactive.
  • Draft: not yet put into service.
  • Active and Inactive: only an entity with one of these statuses can be your default entity, have operating countries or be assigned to a gateway.
  • Archived: taken out of service. It keeps its bank accounts, owners and history, and you can restore it.

​
Entity details

The New Entity page and an entity’s Entity Information tab show the same fields, in this order. Basic Information
  • Legal Company Name (required).
  • Trading Name.
  • Billing Descriptor: a name your customers will recognize. It can be up to 22 characters long and use letters, numbers, spaces and & , . ' # * -.
Registered Office Address
  • Country (required).
  • Street Address (required) and Address Line 2.
  • City, State/Province and Postal Code (all required).
  • Registered office address and principal place of business are the same: ticked by default. If the entity’s principal place of business is at another address, untick it and fill in the Principal Place of Business section that appears. It has the same address fields.
Additional Information
  • Classification (required): Corporation, LLC, Partnership or Sole Proprietorship.
  • Primary Merchant Category Code (MCC) (required) and Secondary Merchant Category Code (MCC). Each option shows the code and its name.
  • Phone.
  • Website: a full web address, such as https://shop.example.com.
Tax Information & Registration
  • Registration Number and Tax ID.
  • Date of Incorporation (required).

​
The entity’s page

When you open an entity, its legal company name is the page title, and the header has Save and an Actions menu. The page has two tabs, Entity Information and Bank Accounts. The Entity Information tab shows the entity’s details, then Operating Countries. Beside them, a Settings panel has:
  • Status: choose Draft, Active or Inactive. Your default entity can’t be moved to Draft. For an archived entity, the menu shows Archived and offers Restore to Active and Restore to Inactive. You can change the status only once all required fields are filled in.
  • Default Entity: makes this entity the main and fallback entity for billing and tax.
Status and Default Entity save as soon as you change them. Save saves the entity’s details, and it appears only on the Entity Information tab.

​
Operating countries

Operating Countries lists the countries the entity operates in. A country can belong to only one entity. Add Country is above the table, which has these columns:
  • Country.
  • Currency and Settlement Currency.
  • Warehouse.
  • Legally Registered: Yes or No.
  • Default: shows Default for the country set as the default.
Each row’s three-dot menu has Edit and Remove. Add Country and Edit open a side panel titled Add Country or Edit Country, with the entity’s name under the title. Under Country & Market Configuration, it has:
  • Country (required): where the entity operates and processes payments. Choose a country that isn’t already on the Countries screen. Countries already on this entity aren’t listed. A country that belongs to another entity is greyed out and shows Assigned to with that entity’s name.
  • Warehouse (required): the warehouse that fulfills orders for the country.
  • Currency Configuration: Auth Currency (required) is the currency customers see at checkout and authorization. Settlement Currency (required) is the currency funds settle to your account in. When you choose a country, the auth currency is filled in with that country’s currency, unless you’ve already picked one. Tick Auth and Settlement currencies are the same to set both with a single Currency field. When you set them separately, a note says that currency conversion happens automatically at settlement and that fees and exchange rates may apply.
  • Entity is legally registered in this country: tick it to confirm the entity is registered and authorized to do business in the country.
  • Set as default country: uses this country as the default for new configurations. Your company has one default country. Ticking this replaces the current one, which the Countries screen marks Default.
The panel ends with Cancel and Save.

​
Bank Accounts tab

The Bank Accounts tab lists the entity’s bank accounts. The Add Bank Account button is on the tab row. The table has these columns:
  • Bank Name. A Payout badge marks your default payout account.
  • Account Holder.
  • Account Number: masked, so only the last four digits show.
  • Currency and Country.
  • Status: Active or Inactive.
Each row’s three-dot menu has Edit and Remove. Add Bank Account and Edit open a side panel titled Add Bank Account or Edit Bank Account. Under Bank Information, it has:
  • Bank Name (required): the official name of the bank that holds the account.
  • Country (required) and City.
  • Account Holder Name (required): the legal name on the account, business or personal.
  • Currency (required): the currency payouts are deposited in.
  • Account Number (required), as your bank provides it.
  • Confirm Account Number (required): appears only when you add an account. Type the account number again. It has to match.
  • Routing Number: the bank identifier for domestic transfers. It appears when Country is the United States, Canada or Australia, and it’s required for the United States.
  • SWIFT/BIC (required): the international bank identifier for cross-border transfers. It appears for every country except the United States.
Under Account Settings, it has:
  • Legal Entity (required): starts as the entity you’re viewing. The list shows your Active and Inactive entities and the entity you’re viewing.
  • Default Payout Account: payouts settle to this account. Your company can have only one default payout account, so turning this on replaces the current one, even if it’s on another entity.
  • Active: on by default. Inactive accounts are hidden from payout selection.
The panel ends with Cancel and Save. When you edit an account, its account and routing numbers appear masked. Leave them as they are to keep the stored numbers.

​
Add an entity

1

Open the form

Click Add Entity. The New Entity page opens.
2

Enter the entity's details

Fill in the required fields. If the principal place of business is at another address, untick Registered office address and principal place of business are the same and fill in that address too.
3

Create the entity

Click Create Entity. The button stays unavailable until all required fields are valid. You see Entity created successfully, and the list opens. The new entity is Inactive.
To add bank accounts, or countries that aren’t already on the Countries screen, open the new entity from the list.

​
Edit an entity

1

Open the entity

Click its row, or choose Edit from its three-dot menu.
2

Change the details

On the Entity Information tab, change the fields you need.
3

Save

Click Save in the header. You see Entity updated successfully.

​
Change the default entity

The default entity has to be Active or Inactive. To make an entity the default, open it and turn on Default Entity. The previous default stops being the default. You can also start from the current default:
1

Turn off Default Entity

Open the current default entity and turn off Default Entity. The Choose a new default entity dialog opens and lists your other Active and Inactive entities.
2

Choose the new default

Select the entity to take over and click Set as Default. You see Default entity updated.
If no other entity is Active or Inactive, you can’t turn off Default Entity on the current default.

​
Add an operating country

You can add countries only to an Active or Inactive entity, and only countries that aren’t already on the Countries screen. A country you add here also appears on the Countries screen.
1

Open the panel

On the entity’s Entity Information tab, click Add Country.
2

Choose the country and warehouse

Choose a Country that isn’t already on the Countries screen, then the Warehouse that fulfills its orders.
3

Set the currencies

Check the Auth Currency and choose a Settlement Currency. If they’re the same, you can tick Auth and Settlement currencies are the same instead.
4

Save

Tick Entity is legally registered in this country if it applies, and Set as default country if you want this country as the default. Click Save. You see Country created successfully.
To change a country, choose Edit from its three-dot menu, make your changes and click Save. You see Country updated successfully.

​
Remove an operating country

Removing a country removes it from your company, not just from this entity, along with its settings and its links to gateways and agreements. It also disappears from the Countries screen. This can’t be undone.
1

Choose Remove

In the country’s three-dot menu, choose Remove.
2

Confirm

In the Delete Country dialog, click Delete. You see Country deleted successfully.
If something still ties your company to the country, the removal is refused and the message says why.

​
Add a bank account

1

Open the panel

On the entity’s Bank Accounts tab, click Add Bank Account.
2

Enter the account details

Choose the Country first, because it decides which of Routing Number and SWIFT/BIC appear. Fill in the other bank and account fields, and type the account number again in Confirm Account Number.
3

Choose the account settings

To have payouts settle to this account, turn on Default Payout Account. To add the account as inactive, turn off Active.
4

Save

Click Save. You see Bank account created successfully.
To change an account, choose Edit from its three-dot menu, make your changes and click Save. You see Bank account updated successfully. To delete an account, choose Remove, then click Delete in the Delete Bank Account dialog. You see Bank account deleted successfully.

​
Archive or restore an entity

Archive an entity to retire it. It keeps its bank accounts, owners and history, but it can no longer be the default entity, take new payment accounts or have countries assigned. Archiving is refused while the entity is still the default, still has live payment accounts, such as a gateway, or still has operating countries. The message names what to move or resolve first. The same rules apply when you move an entity to Draft.
1

Choose Archive

In the list, choose Archive from the entity’s three-dot menu. Or, on the entity’s page, open Actions and choose Archive Entity.
2

Confirm

In the Archive Entity dialog, click Archive Entity. You see Entity archived.
To restore an archived entity, choose Restore from its three-dot menu, or Restore Entity from Actions on its page. It becomes Active, and you see Entity restored. To bring it back as Inactive instead, open it and choose Restore to Inactive under Status.

​
Delete a draft entity

You can delete only a Draft entity that isn’t your default and has no operating countries. To retire any other entity, archive it.
Deleting an entity can’t be undone. Its bank accounts and owners are deleted with it.
1

Choose Delete Entity

On the entity’s page, open Actions and choose Delete Entity.
2

Confirm

In the Delete Entity dialog, type DELETE and click Delete Entity. You see Entity deleted successfully, and the list opens.
You can also choose Remove from the entity’s three-dot menu in the list, then click Delete in the Delete Entity dialog. If something still depends on the entity, such as a live payment account, the delete is refused and the message says what to move or resolve first.

​
Frequently asked questions

On the Gateways screen, you can assign an Entity to a gateway. Only an Active or Inactive entity can be assigned. For a gateway that supports 3DS, its 3DS merchant info comes from that entity: the Legal Company Name, the registered office Country, the Primary Merchant Category Code (MCC) and the Website. Anything the entity leaves blank comes from your company settings, and so does all of it when the gateway has no entity. See Gateways.
The Entities item appears only if your role can view business entities. Ask an admin who manages roles to edit your role’s permissions: open the Commerce card, then set Business Entities to View only or Full access. See Roles.
Changes need Full access for Business Entities. With View only, the Add Entity button and the three-dot menus don’t appear, and an entity’s page is read-only. It has no Save or Actions, you can’t change Status or Default Entity, and Add Country and Add Bank Account don’t appear. Ask an admin who manages roles to set Business Entities to Full access, in the Commerce card. See Roles.