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

# Invoices

> Bill a customer with a dedicated one-time virtual account. When it's funded, the invoice is marked paid and you get a webhook.

An **invoice** is a request for payment backed by a dedicated one-time virtual account. You create the invoice with an amount; Numero mints a payment account for it; when the customer funds that account, a `FUNDING_NOTIFICATION` webhook fires and the invoice is automatically marked **paid**.

## How it works

```
1. Create invoice   →  Numero returns an invoice number + a payment account
2. Share it         →  Send the customer the amount + payment account (or the hosted pay link)
3. Customer pays    →  They transfer into the invoice's virtual account
4. Auto-reconciled  →  Invoice flips to PAID and a webhook is delivered
```

## Statuses

| Status      | Meaning                                                  |
| ----------- | -------------------------------------------------------- |
| `PENDING`   | Awaiting payment                                         |
| `PAID`      | Funded and reconciled                                    |
| `CANCELLED` | Cancelled before payment; the payment account is retired |

## Endpoints

| Method | Endpoint                                           | Description              |
| ------ | -------------------------------------------------- | ------------------------ |
| POST   | `/api/v1/business/invoices`                        | Create an invoice        |
| GET    | `/api/v1/business/invoices`                        | List invoices            |
| GET    | `/api/v1/business/invoices/{invoiceNumber}`        | Get an invoice           |
| POST   | `/api/v1/business/invoices/{invoiceNumber}/cancel` | Cancel an unpaid invoice |