Why?

In environments like Supabase Edge Functions (Deno), Cloudflare Workers, and Vercel Edge:

• constructEventAsync does not support v2.core.event webhooks
• It suggests using stripe.parseEventNotification
• However, parseEventNotification relies on a synchronous crypto provider

This results in the runtime error:

SubtleCryptoProvider cannot be used in a synchronous context

Since these environments only support asynchronous cryptography, there is currently no way to validate v2.core.event webhooks.

What?

• Added parseEventNotificationAsync implementation
• Preserved backward compatibility (no changes to existing sync APIs)
• updated tests

Usage

const event = await stripe.parseEventNotificationAsync(
  body,
  signature,
  endpointSecret
);

Notes

• No breaking changes
• Unblocks Stripe webhook validation in modern edge runtimes
  • Supabase Edge Functions
  • Cloudflare Workers
  • Vercel Edge Functions
• Aligns SDK behavior with existing async patterns (constructEventAsync)
  • About this, i didn't like how it was done (function/code duplication) but it was done following the same bad patterns as in constructEvent and constructEventAsync

See Also

• constructEventAsync suggests parseEventNotification, which fails in async-only environments #2684