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

# Payment statuses

> Invoice and payment row status enums.

See [How Meum payments work](/introduction/how-payments-work) for the end-to-end flow.

## Invoice statuses

```
pending | quoted | awaiting_payment | paid | underpaid | expired | failed | refunded | cancelled
```

**Open** (can still receive payment): `awaiting_payment`, `quoted`, `pending`

**Terminal** (no further payment updates): `paid`, `underpaid`, `failed`, `expired`, `refunded`, `cancelled`

## Payment row statuses

Tracks the on-chain payment record (separate from invoice status):

| Status      | Description                     |
| ----------- | ------------------------------- |
| `pending`   | Detected, awaiting confirmation |
| `completed` | Fully confirmed                 |
| `underpaid` | Less than expected              |
| `overpaid`  | More than expected              |
| `failed`    | Payment failed                  |

## Webhook mapping

| Invoice status | Event               | Default subscription      |
| -------------- | ------------------- | ------------------------- |
| (on create)    | `invoice.created`   | Yes                       |
| `paid`         | `invoice.paid`      | Yes                       |
| `underpaid`    | `invoice.underpaid` | Yes                       |
| `failed`       | `invoice.failed`    | Yes                       |
| `expired`      | `invoice.expired`   | Yes                       |
| `cancelled`    | `invoice.cancelled` | Yes (Woo managed)         |
| `refunded`     | `invoice.refunded`  | No: platform polling only |

## Related pages

* [Event reference](/webhooks/event-reference)
* [Underpayment and overpayment](/payments/underpayment-and-overpayment)