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 |
webhook.test.
| 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. |
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.
| 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
