---
sidebar_position: 10
title: Invoices
description: Where the invoice for a card payment comes from, how to put your company name, address and VAT or tax id on it, and what a crypto or TAO top-up gets instead.
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

Every card top-up gets a Stripe invoice. It is the PDF behind the download icon in the **Invoice** column of **Billing → Billing History**, and it prints whatever the Stripe customer record for your account carries at the moment the invoice is issued: a name, an address and a tax id.

*Shipped with lium-platform#286 (this page's PR):* the **Invoice Details** card on the **Billing** page lets you set those three things yourself. On a deployment that predates it, the invoice shows the name and address you entered when you added the card (or just your account name when the card has no address), and no tax id.

## Invoice Details

On **Billing**, further down the page below your balance, saved cards and the referral banner, fill in the **Invoice Details** card and click **Save Changes**:

| Field | What it does |
|-------|--------------|
| **Company Name** | Printed as the customer name on the invoice. It is the same company name as on your **Profile** page, but it reaches the invoice only once you have saved this card; after that, a rename on either page applies before the next invoice. Empty → your account name is printed instead. |
| **Address Line 1 / 2**, **City**, **State / Province**, **Postal Code** | The billing address block. All optional. |
| **Country** | Required as soon as any address field or the tax id is filled in — the tax id type Stripe records is derived from it. |
| **Tax / VAT ID** | Your VAT number, EIN, ABN, GST number, … Printed in the invoice header. Optional. |

The details apply **from the next card payment on**. Invoices already issued are not regenerated.

Leave a field empty to drop it from the invoice. Saving the card with every field empty removes the address and tax id from your Stripe customer record; the invoice then shows your account name only.

### What the tax id check does

The tax id is checked for the **shape** the selected country uses before it is saved — for example an EU VAT number has to start with the member state's prefix (`DE123456789`, `EL123456789` for Greece, `XI…` for Northern Ireland), a UK VAT number with `GB`, a US EIN is `12-3456789`, an Australian ABN is 11 digits. For plain letter-and-digit ids spaces, dots and hyphens are ignored, so `DE 123 456 789` is fine; the ids whose official form carries punctuation (`12-3456789`, `CHE-123.456.789 MWST`, `12.345.678/0001-95`) are matched as written, with the punctuation optional but no extra spaces. A value that does not fit is refused with a message naming the expected shape, and nothing is saved.

Lium checks the shape only — it does not look the number up in any registry. Stripe checks the shape once more when the id is stored and, for EU VAT, UK VAT and Australian ABN numbers, verifies them against VIES, HMRC and the ABR in the background; that result is visible to Lium's finance team in Stripe, not on the Billing page, and the invoice prints the id either way. If Stripe refuses a value, the card shows Stripe's message in red after the save; your details are still saved on Lium and you can correct the id.

Tax ids are supported for 62 countries (the EU member states, the UK, Switzerland, Norway, Iceland, the US, Canada, Mexico, Brazil, Argentina, Chile, Australia, New Zealand, Japan, South Korea, Singapore, Hong Kong, Taiwan, India, Indonesia, Thailand, Malaysia, the Philippines, Vietnam, the UAE, Saudi Arabia, Israel, Turkey, South Africa, Egypt, Nigeria, Kenya, Serbia, Georgia, Ukraine, Russia). For another country leave the field empty; the invoice carries the company name and address.

### "Stripe has not confirmed these details yet"

After a save, the details are pushed to your Stripe customer record right away. If that push fails — Stripe could not be reached, or it refused the tax id — the save answers with the reason in red, and from the next visit on the card shows the yellow line *Stripe has not confirmed these details yet; no invoice is issued until it does* (for a profile with a country or tax id, the fields Stripe validates). Your details are saved on Lium either way and are pushed again automatically when the next invoice is due; if that push fails again — Stripe still refusing the tax id, or unreachable — that invoice is not issued (a half-applied change could print two tax ids), your payment and balance are unaffected, and Lium's finance team issues the invoice once the details go through, so correct the id. The line disappears once a push has succeeded.

## Crypto and TAO top-ups

Only card payments produce a Stripe invoice. A crypto or TAO top-up appears in **Billing History** without an **Invoice** entry; the **Download CSV** button above the table exports the history for your records.

Invoice details are set in the web app only; they cannot be read or written with an API key or the CLI yet.