> ## 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.

## Invoice statuses

See [Invoice lifecycle](/payments/invoice-lifecycle) for full descriptions.

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

## Payment row statuses

Separate from invoice status. Tracks the blockchain payment record:

| Status      | Description                             |
| ----------- | --------------------------------------- |
| `pending`   | Payment detected, awaiting confirmation |
| `completed` | Payment fully confirmed                 |
| `underpaid` | Received less than expected             |
| `overpaid`  | Received more than expected             |
| `failed`    | Payment failed                          |

Terminal payment statuses (`completed`, `underpaid`, `overpaid`) must not be overwritten by later failure detection.

## Webhook event mapping (standard merchant events)

| Invoice status | Webhook event       | Default subscription |
| -------------- | ------------------- | -------------------- |
| (on create)    | `invoice.created`   | Yes                  |
| `paid`         | `invoice.paid`      | Yes                  |
| `underpaid`    | `invoice.underpaid` | Yes (Woo managed)    |
| `failed`       | `invoice.failed`    | Yes                  |
| `expired`      | `invoice.expired`   | Yes                  |
| `cancelled`    | `invoice.cancelled` | Yes (Woo managed)    |

## Platform-only webhook mapping

| Invoice status | Webhook event      | Default subscription                                                                   |
| -------------- | ------------------ | -------------------------------------------------------------------------------------- |
| `refunded`     | `invoice.refunded` | **No** — emitted when platform status polling detects a refund; not merchant-initiated |

## Related pages

* [Event reference](/webhooks/event-reference)
* [Webhooks overview](/webhooks/overview)