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

# Webhooks overview

> Meum outbound webhooks for events, headers, delivery, and reliability.

Meum sends HTTP POST webhooks when invoice status changes.

## Events

| Event               | Trigger                                                 |
| ------------------- | ------------------------------------------------------- |
| `invoice.created`   | Invoice created                                         |
| `invoice.paid`      | Full payment received                                   |
| `invoice.underpaid` | Partial payment                                         |
| `invoice.failed`    | Payment failed                                          |
| `invoice.expired`   | Invoice expired                                         |
| `invoice.cancelled` | Invoice cancelled                                       |
| `webhook.test`      | Manual test from dashboard                              |
| `invoice.refunded`  | Platform polling only: **not** in default subscriptions |

WooCommerce managed endpoints subscribe to all invoice events except `webhook.test` and `invoice.refunded`.

Full payload shapes: [Event reference](/webhooks/event-reference).

## Delivery headers

| Header                  | Required      | Description                      |
| ----------------------- | ------------- | -------------------------------- |
| `X-Meum-Event`          | Yes           | Event type                       |
| `X-Meum-Event-Id`       | Yes           | `evt_...`: use for deduplication |
| `X-Meum-Timestamp`      | Yes           | Unix seconds (signature input)   |
| `X-Meum-Signature`      | Yes           | `v1=<hmac_sha256_hex>`           |
| `X-Meum-Integration-Id` | If integrated | `int_...`                        |

Legacy `X-Stablecoin-*` headers are **not** sent.

Verify every delivery: [Verify signatures](/webhooks/verify-signatures).

## Delivery and reliability

| Topic            | Behavior                                                                             |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Retries**      | Up to 6 attempts, exponential backoff from 60s, 10s timeout                          |
| **Ordering**     | Not guaranteed globally; per-invoice events follow the state machine                 |
| **Duplicates**   | Retries may redeliver: dedupe on `X-Meum-Event-Id`                                   |
| **Auto-disable** | Custom developer endpoints disabled after 10 consecutive failures                    |
| **WooCommerce**  | Endpoint auto-created on connect: [Configure endpoint](/webhooks/configure-endpoint) |

## Related pages

* [Configure endpoint](/webhooks/configure-endpoint)
* [Testing webhooks](/webhooks/testing-webhooks)
* [Webhooks API](/api-reference/webhooks-api)