apiwatch

All changes / Stripe

Breaking sdk

stripe-node 23.0.0 made stripe.webhooks.signature.verifyHeader() and verifyHeaderAsync() check the event timestamp against Webhook.DEFAULT_TOLERANCE when no tolerance is passed; before, they skipped the check.

Took effect · stripe-node 23.0.0 — stripe.webhooks.signature.verifyHeader() / verifyHeaderAsync() default timestamp tolerance (and constructEvent with tolerance 0)

Reviewed against the vendor source on Oct 2, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

After upgrading, calls that omit the tolerance argument throw StripeSignatureVerificationError for payloads whose timestamp is older than the default tolerance (300 seconds). Stripe says this mainly affects tests or offline processing, and passing 0 keeps the old behavior. In the same release, passing 0 as the tolerance to stripe.webhooks.constructEvent now skips timestamp verification, where it previously applied the default tolerance.

Breaking: Calls fail after this date.

What to do

Before moving to stripe-node 23, find verifyHeader/verifyHeaderAsync calls that omit the tolerance argument. Keep the new default for webhooks verified as they arrive. Pass 0 only where you verify old payloads on purpose (test fixtures, replays, offline processing). Calls that already pass a tolerance are unaffected. Also review any constructEvent call that passes 0, since that now turns the timestamp check off.

Strings to search for

verifyHeaderverifyHeaderAsync

Counts only in files matching *.js, *.mjs, *.cjs, *.ts, *.mts, *.cts, *.tsx, *.jsx; files that mention stripe; repos that depend on stripe 23.x (npm); or repos that mention "stripe": "^23 or "stripe": "~23 or "stripe": "23 or stripe@^23 or stripe@23 or stripe@npm:^23 or stripe@npm:23 (including dependency manifests).

Source

https://raw.githubusercontent.com/stripe/stripe-node/master/.hark/migration-guides/v23.md