SkillPedia Skills Encyclopedia
中文 EN
Today's updates 2026-11-19 UTC

No new commits yet today

Open the update feed

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.

garethx 1b5cbf0 hookdeck/webhook-skills

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>