Issue one-off invoices

​

Create a one-off invoice

1. Select the customer from the list of customers
2. Click the Actions button in the upper-right corner, then select Create one-off invoice

​

Adding add-ons to one-off invoices

• Dashboard
• API

1. Define a purchase order number, if needed
2. Click Add an add-on to add a line item to the invoice
3. Set the number of units for the add-on
4. Define the add-on billing period (past, present, or future)
5. Edit the unit price, if needed (you can set it to 0)
6. Edit the description displayed on the invoice
7. Click Create one-off invoice to issue it

Assign add-ons to create a one-off invoice

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request POST "$LAGO_URL/api/v1/invoices" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "invoice": {
      "external_customer_id": "hooli_1234",
      "currency": "USD",
      "billing_entity_code": "default",
      "purchase_order_number": "po-1234",
      "fees": [
        {
          "add_on_code": "setup_fee",
          "units": 1,
          "unit_amount_cents": 50000,
          "description": "Implementation fee with a solution engineer",
          "from_datetime": "2025-01-01T00:00:00Z",
          "to_datetime": "2025-12-31T23:59:59Z"
        },
        {
          "add_on_code": "customer_success",
          "units": 2,
          "unit_amount_cents": 100000,
          "description": "One off customer success fee",
          "from_datetime": "2025-01-01T00:00:00Z",
          "to_datetime": "2025-12-31T23:59:59Z"
        }
      ]
    }
  }'

​

Application scope of one-off invoices

• A one-off invoice can include the same add-on several times.
• The currency and billing entity of the one-off invoice can differ from the customer’s defaults: the invoice is issued in the currency and by the billing entity you select for it. Set billing_entity_code to pick the billing entity from the API.
• You can reuse the same add-on for several customers, even when their subscriptions use different currencies. You can also charge a different amount to each of them.
• Coupons or prepaid credits (discounts) do not apply to one-off invoices.
• One-off invoices are subject to taxes. For each fee, Lago applies the tax_codes sent in the payload. If there are none, it falls back to the taxes of the add-on, then to the taxes of the customer, then to the default taxes of the billing entity.

​

Invoicing