Issue one-off invoices

​

Create a one-off invoice

To create a one-off invoice for a specific customer:

1. Select the customer from the list of customers; and
2. Click the “Actions” button located in the upper-right corner and select “Create one-off invoice”.

​

Adding add-ons to one-off invoices

Now that you have started the flow to create a one-off invoice, it’s time to add one or several add-ons to it:

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",
      "fees": [
        {
          "add_on_code": "setup_fee",
          "units": 1,
          "unit_amount_cents": 50000,
          "description": "Implementation fee with a solution engineer"
        },
        {
          "add_on_code": "customer_success",
          "units": 2,
          "unit_amount_cents": 100000,
          "description": "One off customer success fee"
        }
      ]
    }
  }'

​

Application scope of one-off invoices

Here are a few things to keep in mind about one-off invoices:

• One-off invoices are issued immediately and can include the same add-on multiple times.
• If the currency of the customer is already defined, the currency of the one-off invoice must be the same.
• You can use the same add-on to create one-off invoices for multiple customers whose subscriptions don’t have the same currency or to apply a different amount for one of these customers.
• Coupons or prepaid credits (discounts) do not apply to one-off invoices.
• One-off invoices are subject to taxes, as defined in the customer view.

​

Invoicing

As mentioned previously, a one-off invoice is invoiced straight away. You are able to find one-off invoices through webhook with webhook message called invoice.one_off_created.