Skills 2026-10-08 15:17 UTC
webhook-skills
Committed by garethx. Update Category: Bug Fixes & Stability Improvements. Commit details: fix(mollie-webhooks): cover signed next-gen webhooks alongside classic fetch-to-confirm (#218). This update resolves known runtime errors and enhances system reliability.
CommitRaw commit message
fix(mollie-webhooks): cover signed next-gen webhooks alongside classic fetch-to-confirm (#218)
The skill described only classic Mollie webhooks and stated that Mollie has
no signature header ("No signature header (no `X-Mollie-Signature` ...)").
Mollie's Next-gen webhooks page documents signed deliveries:
- "Each event we deliver will contain a `X-Mollie-Signature` header."
- "The signature is an HMAC of the webhook request body, using the SHA-256
hashing algorithm" with the header formatted `sha256=<hex>`; verify over
"the unaltered `POST` body".
- After a secret rotation "each event will contain two signature headers for
the next 24 hours".
Mollie's own TypeScript SDK (mollie-api-typescript SignatureValidator) does the
same: strip `sha256=`, HMAC-SHA256 hex of the raw payload, accept any of
several signatures.
Changes:
- SKILL.md, references: describe both systems; classic keeps the unsigned
fetch-to-confirm path, next-gen gets signature verification, rotation
handling, the JSON event envelope and the documented event types (global vs
beta). Note the docs' conflicting statements on who generates the signing
secret and on using next-gen for payment events, without asserting either.
- Examples (express, nextjs, fastapi): add a next-gen route at
/webhooks/mollie/events (Mollie recommends separate URLs) that verifies the
raw body, accepts either signature during rotation, and refuses to run
without MOLLIE_WEBHOOK_SECRET; tests cover valid, missing, wrong-secret,
tampered, two-header and unset-secret cases.
- Correct "Mollie's official SDKs are Node and PHP": Mollie's libraries page
lists an official Python library (mollie-api-py).
- providers.yaml brief and README row updated so regeneration keeps both
systems.
Docs: https://docs.mollie.com/reference/webhooks-new#manual-signature-verification
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>