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 Create 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 Create a plan in the upper right corner;
  3. Fill in the form (learn more about plans); and
  4. Click Create plan to save.

3. Create a customer

To create a customer through the user interface:
  1. In the side menu, select Customers;
  2. Click Create a customer in the upper right corner;
  3. Fill in the form (learn more about customers); and
  4. Click Create 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. In the Subscriptions section, click Assign a plan;
  4. Select the plan you would like to assign to your customer; and
  5. Click Assign 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 an endpoint;
  4. Enter the name and the URL of your application; and
  5. Click Create endpoint to confirm.
To learn more, see Webhooks and the invoice object.