Skip to main content

Foreword

Each Lago account is associated with a single environment. It is not possible to have your test environment and production environment in the same account. Two workarounds:
  1. Create two accounts to get access to two environments, one that could be called “Company Staging” and another one that could be called “Company Production”; or
  2. Leverage our two hosting solutions to use Lago Cloud as a test environment and Lago Open Source as a production environment (or vice versa).
Both workarounds require you to replicate the same setup in each environment.
In the future, you will be able to get access to a test environment and a production environment with the same Lago account.

1. Define a billable metric

To define a billable metric through the user interface:
  1. In the side menu, select “Billable metrics”;
  2. Click “Add a billable metric” in the upper right corner;
  3. Fill in the form (learn more about billable metrics); and
  4. Click “Add billable metric” to save.

2. Create a plan (with charges)

To create a plan through the user interface:
  1. In the side menu, select “Plans”;
  2. Click “Add a plan” in the upper right corner;
  3. Fill in the form (learn more about plans); and
  4. Click “Add plan” to save.

3. Create a customer

To create a customer through the user interface:
  1. In the side menu, select “Customers”;
  2. Click “Add a customer” in the upper right corner;
  3. Fill in the form in the pop-up window (learn more about customers); and
  4. Click “Add customer” to save.
You can also create customers through the API, as described in the documentation.

4. Start a subscription

To start a subscription, you need to assign a plan to an existing customer. To do so through the user interface:
  1. In the side menu, select “Customers”;
  2. Select a customer from the list;
  3. On the right-hand side, click “Add a plan”;
  4. Select the plan you would like to assign to your customer; and
  5. Click “Add plan” to confirm.
A success toast appears and the new subscription is listed in the customer view. You can also start a subscription through the API, as described in the documentation.

5. Send usage-based events

Lago automatically aggregates the events your backend sends according to the billable metrics you defined (learn more about ingesting usage):

6. Invoice your customers

At the end of the billing period, Lago automatically generates an invoice for each customer and notifies your application with a webhook. To define the URL that receives them:
  1. In the side menu, select “Developers”;
  2. Open the “Webhooks” tab;
  3. Click “Add a webhook”;
  4. Enter the name and the URL of your application; and
  5. Click “Add webhook” to confirm.
To learn more, see Webhooks and the invoice object.