Webhooks overview

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.

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.

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