⚠️ Important difference from Next.js
queue: true does NOT work on Cloudflare Workers. Always use explicit queue config with the env parameter.
Framework — Cloudflare Workers
+Webhook verification at the edge.
+Web Crypto API native. Zero Node.js dependencies. Runs in V8 isolates across Cloudflare's global network.
+ beta +{`import { createWebhookHandler } from '@hookflo/tern/cloudflare'
+
+export interface Env {
+ WEBHOOK_SECRET: string
+ QSTASH_TOKEN: string
+ QSTASH_CURRENT_SIGNING_KEY: string
+ QSTASH_NEXT_SIGNING_KEY: string
+ [key: string]: unknown
+}
+
+export default {
+ async fetch(request: Request, env: Env): Promise {
+ const handler = createWebhookHandler({
+ platform: 'stripe',
+ secret: env.WEBHOOK_SECRET,
+ queue: {
+ token: env.QSTASH_TOKEN,
+ signingKey: env.QSTASH_CURRENT_SIGNING_KEY,
+ nextSigningKey: env.QSTASH_NEXT_SIGNING_KEY,
+ },
+ handler: async (payload) => {
+ return { received: true }
+ }
+ })
+
+ return handler(request, env)
+ }
+}`} Secrets setup
{`WEBHOOK_SECRET=whsec_xxx
+QSTASH_TOKEN=qstash_xxx
+
+npx wrangler secret put WEBHOOK_SECRET
+npx wrangler secret put QSTASH_TOKEN
+npx wrangler secret put QSTASH_CURRENT_SIGNING_KEY
+npx wrangler secret put QSTASH_NEXT_SIGNING_KEY`}Deploy
{`npx wrangler dev
+npx wrangler deploy`}Test locally
- Stripe: stripe listen + stripe trigger
- Clerk: Dashboard → Send test webhook
- GitHub: Redeliver from recent deliveries
- Fal AI: curl queue.fal.run with ngrok URL
- Replicate: curl predictions API with ngrok URL
- Razorpay: dashboard test webhook
Error reference
- "Webhook secret is not configured"
- "Missing signature header: stripe-signature"
- "Queue temporarily unavailable"
- "DeduplicationId cannot contain ':'"