技能 2026-10-08 15:17 UTC
webhook-skills
由提交人 garethx 提交,主要更新类型为:问题缺陷修复与稳定性提升。提交说明:fix(mollie-webhooks): cover signed next-gen webhooks alongside classic fetch-to-confirm (#218)。解决了已知运行时异常与边界错误,提升系统稳定性。
Commit提交信息原文
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>