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.
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
Source
https://raw.githubusercontent.com/stripe/stripe-node/master/.hark/migration-guides/v23.md