> ## 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 webhook architecture and event types.

Meum sends HTTP POST webhooks when invoice status changes.

## Standard merchant events

These events are included in default webhook endpoint subscriptions and cover normal payment integration flows:

| Event               | Trigger                    |
| ------------------- | -------------------------- |
| `invoice.created`   | Invoice created            |
| `invoice.paid`      | Full payment received      |
| `invoice.underpaid` | Partial payment received   |
| `invoice.failed`    | Payment failed             |
| `invoice.expired`   | Invoice expired            |
| `invoice.cancelled` | Invoice cancelled          |
| `webhook.test`      | Manual test from dashboard |

WooCommerce managed integrations subscribe to all events above except `webhook.test`.

## Platform-emitted events (not in default subscriptions)

| Event              | When emitted                                                | Merchant action                                                                             |
| ------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `invoice.refunded` | Platform status polling detects a refund on an open invoice | Not merchant-initiated. Not in default webhook subscriptions. Subscribe manually if needed. |

<Note>
  There is no public merchant API to initiate refunds. The `invoice.refunded` event is emitted by platform status polling only and is **not** part of default WooCommerce managed webhook subscriptions.
</Note>

## Delivery headers

| Header                        | Required                  | Description                                |
| ----------------------------- | ------------------------- | ------------------------------------------ |
| `Content-Type`                | Yes                       | `application/json`                         |
| `X-Stablecoin-Event`          | Yes                       | Event type (e.g. `invoice.paid`)           |
| `X-Stablecoin-Event-Id`       | Yes                       | Unique event ID from payload `id` field    |
| `X-Stablecoin-Timestamp`      | Yes                       | Unix timestamp (seconds) used in signature |
| `X-Stablecoin-Signature`      | Yes                       | `v1=<hmac_sha256_hex>`                     |
| `X-Stablecoin-Integration-Id` | Integration invoices only | Integration UUID                           |

## Related pages

* [Event reference](/webhooks/event-reference)
* [Verify signatures](/webhooks/verify-signatures)