Skip to main content
Managing multiple billing entities is a premium feature. Contact your account manager to enable it for your organization.

​
Create a billing entity

Billing entities let you manage your end customers under distinct billing configurations. To create a billing entity, follow these steps:
Using the user interface:
  1. Click Settings in the side navigation bar.
  2. In the Settings menu, click “Add a billing entity”.
  3. Enter a name and a unique code for your billing entity.
  4. Configure the entity’s settings as needed.
  5. Click “Add billing entity” to confirm.
The first billing entity created in your organization is considered the default.Billing entity settings only apply to the customers assigned to that specific entity. More information is available in the following sections.

​
Edit a billing entity

You can update all billing entity information except the code after creation. To edit a billing entity:
Using the user interface:
  1. Click Settings in the side navigation bar.
  2. In the Settings menu, select the relevant billing entity.
  3. Click any section to edit its settings.

​
Billing entity settings

A billing entity carries the settings that Lago applies to the invoices it issues: Through the API, taxes and invoice custom sections can only be set when you update a billing entity, not when you create one. The billing entity object lists every field.

​
Delete a billing entity

Deleting a billing entity is not available via the Dashboard or API.
To delete a billing entity, contact the Lago team directly.

​
Assign a billing entity to a customer

When creating a customer, you can assign it to a billing entity in two ways:
  • Through the Dashboard by selecting the billing entity.
  • Via API by passing the billing_entity_code in the customer creation payload.
If you do not pass billing_entity_code, Lago assigns the customer to the default billing entity.
The billing entity assigned to a customer acts as their default billing entity.
A customer is not limited to a single billing entity: when creating a billing object for the customer (e.g. a subscription, one-off invoice, or wallet), you can select a billing entity different from the customer’s default. The resulting invoices are issued by the billing entity selected on the object.