<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Tillping</title>
    <description>The latest articles on DEV Community by Tillping (@tillping).</description>
    <link>https://dev.to/tillping</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4206177%2F254be433-f2cb-40e1-86b8-93b30f4ab105.png</url>
      <title>DEV Community: Tillping</title>
      <link>https://dev.to/tillping</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/tillping"/>
    <language>en</language>
    <item>
      <title>Test a declined renewal, not just a successful checkout.</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Thu, 12 Nov 2026 19:07:27 +0000</pubDate>
      <link>https://dev.to/tillping-hq/test-a-declined-renewal-not-just-a-successful-checkout-1lhj</link>
      <guid>https://dev.to/tillping-hq/test-a-declined-renewal-not-just-a-successful-checkout-1lhj</guid>
      <description>&lt;p&gt;A first payment that works in sandbox can hide what happens when the next charge fails.&lt;/p&gt;

&lt;p&gt;Fail a renewal in your test environment and watch the result. Does access stay open, end at once, or follow a grace period you actually chose?&lt;/p&gt;

&lt;p&gt;Providers usually retry the card and send failed-payment or past-due events. If those arrive and your handler returns 200 without changing anything, a customer may keep a paid feature for free, or lose it with no warning.&lt;/p&gt;

&lt;p&gt;Check the notice you'd send them too. A silent change after a failed charge is how angry tickets start.&lt;/p&gt;

</description>
      <category>webhooks</category>
      <category>testing</category>
      <category>webdev</category>
      <category>payments</category>
    </item>
    <item>
      <title>Handle the renewal, not just the first checkout</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Thu, 12 Nov 2026 16:41:56 +0000</pubDate>
      <link>https://dev.to/tillping-hq/handle-the-renewal-not-just-the-first-checkout-1o92</link>
      <guid>https://dev.to/tillping-hq/handle-the-renewal-not-just-the-first-checkout-1o92</guid>
      <description>&lt;p&gt;A payment flow can pass every launch check and still break a month later. The first checkout sends one kind of event, and the renewal often sends a different one. If the handler only knows the first, the renewal lands, gets a polite 200, and nothing extends the customer's access.&lt;/p&gt;

&lt;p&gt;So the card is charged on day 31, the provider shows the subscription as active, and the app quietly downgrades someone who just paid. Nobody notices until that customer writes in, if they write in at all.&lt;/p&gt;

&lt;p&gt;Worth checking before launch. List every event your provider sends over a subscription's life, like renewals, failed payments and cancellations, and make sure each one is either handled or logged loudly. Then run a renewal in sandbox instead of waiting a month to find out 🙂&lt;/p&gt;

</description>
      <category>webhooks</category>
      <category>payments</category>
      <category>testing</category>
      <category>webdev</category>
    </item>
    <item>
      <title>A signed payment can still unlock the wrong thing</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Thu, 12 Nov 2026 14:39:08 +0000</pubDate>
      <link>https://dev.to/tillping-hq/a-signed-payment-can-still-unlock-the-wrong-thing-15b9</link>
      <guid>https://dev.to/tillping-hq/a-signed-payment-can-still-unlock-the-wrong-thing-15b9</guid>
      <description>&lt;p&gt;A valid signature tells you where a payment notification came from. Your app still has to decide what that payment buys.&lt;/p&gt;

&lt;p&gt;In your sandbox, try changing the checkout amount, product ID or account reference.&lt;/p&gt;

&lt;p&gt;The server should own pricing and bind the checkout to the authenticated buyer. Before granting access, match the payment status, currency and purchased product to the stored order, accounting for legitimate discounts and taxes.&lt;/p&gt;

&lt;p&gt;Also test environment separation. A test-mode payment must never unlock live access.&lt;/p&gt;

&lt;p&gt;Custom fields inside a signed notification may originally have come from the browser. A valid signature doesn't make those fields trustworthy.&lt;/p&gt;

</description>
      <category>webhooks</category>
      <category>payments</category>
      <category>security</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Send duplicates at the same time</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Thu, 12 Nov 2026 13:07:03 +0000</pubDate>
      <link>https://dev.to/tillping-hq/send-duplicates-at-the-same-time-293l</link>
      <guid>https://dev.to/tillping-hq/send-duplicates-at-the-same-time-293l</guid>
      <description>&lt;p&gt;Replaying a webhook twice in sequence can miss the race that breaks fulfillment.&lt;/p&gt;

&lt;p&gt;Deliver the same event concurrently in a test environment. Both handlers might check "already processed?" before either saves the answer. Now both grant credits.&lt;/p&gt;

&lt;p&gt;Use an atomic claim, such as a database uniqueness constraint, and commit the local business change consistently with the processing record. External actions need their own protection against repeats.&lt;/p&gt;

&lt;p&gt;Test out-of-order events separately. An event ID identifies a delivery; it doesn't tell you which subscription state is current.&lt;/p&gt;

</description>
      <category>webhooks</category>
      <category>payments</category>
      <category>testing</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Have a recovery plan for missed payments.</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Thu, 12 Nov 2026 11:35:54 +0000</pubDate>
      <link>https://dev.to/tillping-hq/have-a-recovery-plan-for-missed-payments-24bj</link>
      <guid>https://dev.to/tillping-hq/have-a-recovery-plan-for-missed-payments-24bj</guid>
      <description>&lt;p&gt;Webhook retries eventually stop. Your recovery plan needs to work after that point.&lt;/p&gt;

&lt;p&gt;A useful sandbox drill is to make the endpoint unavailable, complete a test payment, then restore it and follow your provider's recovery procedure.&lt;/p&gt;

&lt;p&gt;Can you find the payment your app missed? Can you repair the missing access without granting it twice?&lt;/p&gt;

&lt;p&gt;Compare provider payment records with local orders and access records. Make discrepancies visible and repairs safe to repeat.&lt;/p&gt;

&lt;p&gt;An empty webhook error log won't reveal a payment your application never received.&lt;/p&gt;

</description>
      <category>webhooks</category>
      <category>payments</category>
      <category>testing</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Test what your signature verifier rejects</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Tue, 10 Nov 2026 13:10:01 +0000</pubDate>
      <link>https://dev.to/tillping-hq/test-what-your-signature-verifier-rejects-1mj</link>
      <guid>https://dev.to/tillping-hq/test-what-your-signature-verifier-rejects-1mj</guid>
      <description>&lt;p&gt;A valid webhook passing verification is only half the test.&lt;/p&gt;

&lt;p&gt;In a test environment, change one byte of a signed request without changing its signature. Then try a missing signature and the wrong endpoint secret.&lt;/p&gt;

&lt;p&gt;Every rejected request should leave orders, access and background jobs untouched.&lt;/p&gt;

&lt;p&gt;Use your provider's documented verification method. Signature formats and replay protection differ. Keep secrets out of logs, and test rotation before you need it during an incident.&lt;/p&gt;

</description>
      <category>webhooks</category>
    </item>
    <item>
      <title>Test payment without the success page</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Mon, 09 Nov 2026 11:08:58 +0000</pubDate>
      <link>https://dev.to/tillping-hq/test-payment-without-the-success-page-32mk</link>
      <guid>https://dev.to/tillping-hq/test-payment-without-the-success-page-32mk</guid>
      <description>&lt;p&gt;Finish a sandbox checkout, then close the tab before it returns to your app.&lt;/p&gt;

&lt;p&gt;Open a fresh session and try the paid feature. Check the actual permission, not just the “Pro” badge.&lt;/p&gt;

&lt;p&gt;If access depends on visiting the success page, a customer can pay and never get upgraded. Fulfillment should follow verified server-side payment state, linked to the correct order and account.&lt;/p&gt;

&lt;p&gt;Then test a refund and a subscription cancellation. Define the expected access first. Cancelling renewal isn’t necessarily the same as ending access immediately.&lt;/p&gt;

</description>
      <category>architecture</category>
      <category>backend</category>
      <category>saas</category>
      <category>testing</category>
    </item>
    <item>
      <title>Stripe webhook signature verification failed: 3 things to check</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Mon, 02 Nov 2026 13:16:39 +0000</pubDate>
      <link>https://dev.to/tillping-hq/stripe-webhook-signature-verification-failed-3-things-to-check-174o</link>
      <guid>https://dev.to/tillping-hq/stripe-webhook-signature-verification-failed-3-things-to-check-174o</guid>
      <description>&lt;p&gt;&lt;em&gt;This article was created with the help of AI. Each step was checked against the Stripe docs and the stripe-node library listed at the end.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Here's why this error matters. A customer pays, Stripe sends your app a webhook, and your app turns it away because the signature check fails. The customer paid and gets nothing. Stripe keeps retrying for a while, but you may not notice until someone writes in, upset. The good news: the cause is almost always one of three small things.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The error:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Webhook signature verification failed.
No signatures found matching the expected signature for payload.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Short answer:&lt;/strong&gt; Stripe's check uses three things: the raw request body, the &lt;code&gt;Stripe-Signature&lt;/code&gt; header and your endpoint's signing secret. If any one of them is wrong, the check fails. Stripe says the most common cause is the &lt;strong&gt;wrong secret&lt;/strong&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Check 1: Is it the right secret?
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The secret starts with &lt;code&gt;whsec_&lt;/code&gt;. It is &lt;strong&gt;not&lt;/strong&gt; your API key (&lt;code&gt;sk_...&lt;/code&gt;) and &lt;strong&gt;not&lt;/strong&gt; the endpoint ID (&lt;code&gt;we_...&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;The secret from &lt;code&gt;stripe listen&lt;/code&gt; on your laptop is &lt;strong&gt;different&lt;/strong&gt; from the secret of an endpoint you made in the Stripe Dashboard. Don't mix them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test mode and live mode use different secrets.&lt;/strong&gt; When you go live, copy the live endpoint's secret.&lt;/li&gt;
&lt;li&gt;To find it: in Stripe, open the endpoint and click &lt;strong&gt;Reveal secret&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Look for a space or line break at the end of the value in your environment variables.&lt;/li&gt;
&lt;li&gt;Changed the value on your host? Deploy again. Many hosts only load new values on a new deploy.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Check 2: Is the body untouched?
&lt;/h2&gt;

&lt;p&gt;Stripe signs the exact bytes it sends. If your app turns the body into JSON and back, the bytes change and the check fails. Get the &lt;strong&gt;raw&lt;/strong&gt; body.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Next.js (App Router):&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/api/webhooks/stripe/route.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;stripe&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;STRIPE_SECRET_KEY&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;POST&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Request&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;text&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="c1"&gt;// raw text. Do not use req.json()&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;sig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;stripe-signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;sig&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Missing signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;400&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;

  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;Event&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;event&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;webhooks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;constructEvent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;sig&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;STRIPE_WEBHOOK_SECRET&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Webhook Error: &lt;/span&gt;&lt;span class="p"&gt;${(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt; &lt;span class="kd"&gt;as &lt;/span&gt;&lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;400&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="c1"&gt;// handle event.type here&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;received&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Express:&lt;/strong&gt; put the raw parser on the webhook route, and add &lt;code&gt;express.json()&lt;/code&gt; &lt;strong&gt;after&lt;/strong&gt; it.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/webhook&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;express&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;application/json&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;}),&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;event&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;event&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;webhooks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;constructEvent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;stripe-signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="nx"&gt;endpointSecret&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;400&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Webhook Error: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="c1"&gt;// handle event.type here&lt;/span&gt;
  &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;received&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;

&lt;span class="nx"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;use&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;express&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;())&lt;/span&gt; &lt;span class="c1"&gt;// other routes only&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Next.js (Pages Router):&lt;/strong&gt; turn off the body parser for this route and read the raw bytes.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// pages/api/webhook.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;NextApiRequest&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;NextApiResponse&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;next&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;stripe&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;config&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;api&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;bodyParser&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;STRIPE_SECRET_KEY&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;rawBody&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;NextApiRequest&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
  &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="k"&gt;await &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;chunk&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;typeof&lt;/span&gt; &lt;span class="nx"&gt;chunk&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;string&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;concat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;handler&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;NextApiRequest&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;NextApiResponse&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;method&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;POST&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;405&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;end&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;sig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;stripe-signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="kd"&gt;as &lt;/span&gt;&lt;span class="kr"&gt;string&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;event&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;webhooks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;constructEvent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;rawBody&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="nx"&gt;sig&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;STRIPE_WEBHOOK_SECRET&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="c1"&gt;// handle event.type here&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;received&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;400&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Webhook Error: &lt;/span&gt;&lt;span class="p"&gt;${(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt; &lt;span class="kd"&gt;as &lt;/span&gt;&lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Supabase Edge Functions (Deno):&lt;/strong&gt; use &lt;code&gt;await req.text()&lt;/code&gt;, and use the async version with Stripe's crypto provider:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cryptoProvider&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;createSubtleCryptoProvider&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;event&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;webhooks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;constructEventAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;secret&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cryptoProvider&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The plain &lt;code&gt;constructEvent&lt;/code&gt; fails there with "SubtleCryptoProvider cannot be used in a synchronous context". Supabase also blocks Stripe with a 401 by default until you set &lt;code&gt;verify_jwt = false&lt;/code&gt; for the webhook function.&lt;/p&gt;

&lt;p&gt;Something in front of your app can also change the body, such as a proxy or a forwarding tool. Even a small change, like extra spaces in the JSON, breaks the check.&lt;/p&gt;

&lt;h2&gt;
  
  
  Check 3: Is the header right?
&lt;/h2&gt;

&lt;p&gt;Print the &lt;code&gt;Stripe-Signature&lt;/code&gt; header once. It should look like &lt;code&gt;t=...,v1=...&lt;/code&gt;. If it is empty, your code is reading the wrong header, or something in between removed it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Tip: a "too old" error
&lt;/h2&gt;

&lt;p&gt;Stripe's libraries also reject events whose timestamp is more than 5 minutes off from your server's clock (the default). If you replay a saved request later, it will fail. Send a fresh test event instead, and make sure your server's clock is correct.&lt;/p&gt;

&lt;h2&gt;
  
  
  Make sure fake signatures are refused
&lt;/h2&gt;

&lt;p&gt;Once real events pass, check the other side: your endpoint must say no to a bad signature. Try it on your own endpoint:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-i&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST https://yourapp.com/api/webhooks/stripe &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s1"&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-H&lt;/span&gt; &lt;span class="s1"&gt;'Stripe-Signature: t=1,v1=bad'&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;-d&lt;/span&gt; &lt;span class="s1"&gt;'{}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You want a 4xx, such as 400. If you get a 2xx, your route is not checking the signature.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Stripe, Resolve webhook signature verification errors: &lt;a href="https://docs.stripe.com/webhooks#verify-events" rel="noopener noreferrer"&gt;https://docs.stripe.com/webhooks#verify-events&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Stripe, Webhooks: &lt;a href="https://docs.stripe.com/webhooks" rel="noopener noreferrer"&gt;https://docs.stripe.com/webhooks&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Stripe Node library (&lt;code&gt;constructEvent&lt;/code&gt;, &lt;code&gt;constructEventAsync&lt;/code&gt;): &lt;a href="https://github.com/stripe/stripe-node" rel="noopener noreferrer"&gt;https://github.com/stripe/stripe-node&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Supabase example code (Deno): &lt;a href="https://github.com/supabase/supabase/blob/master/examples/edge-functions/supabase/functions/stripe-webhooks/index.ts" rel="noopener noreferrer"&gt;https://github.com/supabase/supabase/blob/master/examples/edge-functions/supabase/functions/stripe-webhooks/index.ts&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;More plain-English webhook fix guides: &lt;a href="https://tillping.online/fix?ref=dev" rel="noopener noreferrer"&gt;https://tillping.online/fix?ref=dev&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Tillping is a small tool that checks the payment-webhook path of your app, so a paying customer isn't left with nothing while you hear nothing. It isn't open yet. If you'd like a heads-up when it is, join the early-bird list: &lt;a href="https://tillping.online/?ref=dev" rel="noopener noreferrer"&gt;https://tillping.online/?ref=dev&lt;/a&gt;&lt;/p&gt;

</description>
      <category>stripe</category>
      <category>webhooks</category>
      <category>nextjs</category>
      <category>node</category>
    </item>
    <item>
      <title>Stripe webhook to a Supabase Edge Function returns 401: how to fix it</title>
      <dc:creator>Tillping</dc:creator>
      <pubDate>Sun, 25 Oct 2026 13:10:26 +0000</pubDate>
      <link>https://dev.to/tillping-hq/stripe-webhook-to-a-supabase-edge-function-returns-401-how-to-fix-it-56pc</link>
      <guid>https://dev.to/tillping-hq/stripe-webhook-to-a-supabase-edge-function-returns-401-how-to-fix-it-56pc</guid>
      <description>&lt;p&gt;&lt;em&gt;This article was created with the help of AI. Each step was checked against the Supabase and Stripe docs listed at the end.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Short answer:&lt;/strong&gt; Supabase checks every call to an Edge Function for a login token (a JWT). Stripe does not send one. So Supabase turns Stripe away with a 401 &lt;strong&gt;before your code runs&lt;/strong&gt;. Turn that check off for the webhook function only, then check Stripe's signature in your code.&lt;/p&gt;

&lt;h2&gt;
  
  
  Signs you have this problem
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;In Stripe, the webhook's &lt;strong&gt;Event deliveries&lt;/strong&gt; tab shows failed deliveries with status &lt;strong&gt;401&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;The reply body says something like &lt;code&gt;Missing authorization header&lt;/code&gt; or &lt;code&gt;Invalid JWT&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Your function logs show &lt;strong&gt;nothing&lt;/strong&gt;, because your code never ran.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If the 401 body is a message &lt;strong&gt;you&lt;/strong&gt; wrote, the 401 comes from your own code, not from Supabase. Look at your handler instead.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Turn off the JWT check for this one function
&lt;/h2&gt;

&lt;p&gt;Pick one way.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A. In &lt;code&gt;supabase/config.toml&lt;/code&gt; (best, because it lives in your code):&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight toml"&gt;&lt;code&gt;&lt;span class="k"&gt;[&lt;/span&gt;&lt;span class="n"&gt;functions&lt;/span&gt;&lt;span class="k"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stripe-webhook&lt;/span&gt;&lt;span class="k"&gt;]&lt;/span&gt;
&lt;span class="n"&gt;verify_jwt&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then deploy again:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;supabase functions deploy stripe-webhook
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;B. With a flag when you deploy:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;supabase functions deploy stripe-webhook &lt;span class="nt"&gt;--no-verify-jwt&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;C. In the Supabase Dashboard:&lt;/strong&gt; open the function and switch off JWT verification.&lt;/p&gt;

&lt;p&gt;Keep config.toml and the Dashboard setting the same.&lt;/p&gt;

&lt;p&gt;When you test on your laptop, use &lt;code&gt;supabase functions serve --no-verify-jwt&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Important:&lt;/strong&gt; with the check off, anyone who knows the address can call this function. The Stripe signature check in Step 2 is now your only lock. Do not skip it. Keep the JWT check on for all your other functions.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Check the Stripe signature in your code
&lt;/h2&gt;

&lt;p&gt;Three rules:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Read the body as &lt;strong&gt;raw text&lt;/strong&gt; with &lt;code&gt;await req.text()&lt;/code&gt;. Do not call &lt;code&gt;req.json()&lt;/code&gt; first, or the signature will never match.&lt;/li&gt;
&lt;li&gt;On Supabase (which runs Deno), use &lt;strong&gt;&lt;code&gt;constructEventAsync&lt;/code&gt;&lt;/strong&gt; with Stripe's crypto provider. The plain &lt;code&gt;constructEvent&lt;/code&gt; does not work here.&lt;/li&gt;
&lt;li&gt;Use the signing secret (&lt;code&gt;whsec_...&lt;/code&gt;) of &lt;strong&gt;this exact endpoint&lt;/strong&gt;.
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// supabase/functions/stripe-webhook/index.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;npm:stripe@^22&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="c1"&gt;// version taken from Supabase's own example&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;Deno&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;STRIPE_API_KEY&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;cryptoProvider&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;createSubtleCryptoProvider&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;

&lt;span class="nx"&gt;Deno&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;serve&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;async &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;signature&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Stripe-Signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Missing signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;400&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;text&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="c1"&gt;// raw text, not JSON&lt;/span&gt;

  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="na"&gt;event&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;Event&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;event&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;stripe&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;webhooks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;constructEventAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
      &lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nx"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nx"&gt;Deno&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;STRIPE_WEBHOOK_SIGNING_SECRET&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="kc"&gt;undefined&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nx"&gt;cryptoProvider&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Bad signature:&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;err&lt;/span&gt; &lt;span class="kd"&gt;as &lt;/span&gt;&lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Invalid signature&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;400&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="c1"&gt;// Handle the events you need here, e.g. checkout.session.completed&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`Got &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; (&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;received&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This matches Supabase's own example (&lt;code&gt;examples/edge-functions/supabase/functions/stripe-webhooks/index.ts&lt;/code&gt; in the supabase/supabase repo). Their example wraps the handler in &lt;code&gt;withSupabase({ auth: 'none' })&lt;/code&gt; from &lt;code&gt;npm:@supabase/server&lt;/code&gt;. Plain &lt;code&gt;Deno.serve&lt;/code&gt; does the same job.&lt;/p&gt;

&lt;p&gt;Save your keys as secrets, not in code:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;supabase secrets &lt;span class="nb"&gt;set &lt;/span&gt;&lt;span class="nv"&gt;STRIPE_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;sk_live_... &lt;span class="nv"&gt;STRIPE_WEBHOOK_SIGNING_SECRET&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;whsec_...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  What often goes wrong next
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;You see&lt;/th&gt;
&lt;th&gt;What it means&lt;/th&gt;
&lt;th&gt;Fix&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;400 "No signatures found matching the expected signature"&lt;/td&gt;
&lt;td&gt;Wrong secret, or the body changed&lt;/td&gt;
&lt;td&gt;Use the &lt;code&gt;whsec_&lt;/code&gt; of this endpoint. Test and live have different secrets. The &lt;code&gt;stripe listen&lt;/code&gt; secret is different from the Dashboard one.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;500 "SubtleCryptoProvider cannot be used in a synchronous context"&lt;/td&gt;
&lt;td&gt;You used &lt;code&gt;constructEvent&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Use &lt;code&gt;constructEventAsync&lt;/code&gt; with &lt;code&gt;Stripe.createSubtleCryptoProvider()&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;200 but the user is not upgraded&lt;/td&gt;
&lt;td&gt;The event arrived, but the database write failed or found no user&lt;/td&gt;
&lt;td&gt;Read your function logs for the database error. Check how you match the Stripe customer or session to a user in your app.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Test it
&lt;/h2&gt;

&lt;p&gt;On your laptop:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;supabase functions serve stripe-webhook &lt;span class="nt"&gt;--no-verify-jwt&lt;/span&gt; &lt;span class="nt"&gt;--env-file&lt;/span&gt; ./supabase/.env
stripe listen &lt;span class="nt"&gt;--forward-to&lt;/span&gt; http://localhost:54321/functions/v1/stripe-webhook
stripe trigger checkout.session.completed
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Put the &lt;code&gt;whsec_&lt;/code&gt; that &lt;code&gt;stripe listen&lt;/code&gt; prints into your local &lt;code&gt;.env&lt;/code&gt; file.&lt;/p&gt;

&lt;p&gt;After you deploy, check that the JWT wall is gone. Send a POST with no signature to your own function:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-i&lt;/span&gt; &lt;span class="nt"&gt;-X&lt;/span&gt; POST https://YOUR-PROJECT-REF.supabase.co/functions/v1/stripe-webhook
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;A 401 that mentions a JWT or a missing authorization header means Supabase is still blocking outside callers. Go back to Step 1.&lt;/li&gt;
&lt;li&gt;A 400 &lt;code&gt;Missing signature&lt;/code&gt; comes from your own code. That is good: Stripe can now reach it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Then send a test event from the Stripe Dashboard and look at &lt;strong&gt;Event deliveries&lt;/strong&gt;. You want a 2xx.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Supabase, Securing Edge Functions: &lt;a href="https://supabase.com/docs/guides/functions/auth" rel="noopener noreferrer"&gt;https://supabase.com/docs/guides/functions/auth&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Supabase, Function configuration (&lt;code&gt;verify_jwt&lt;/code&gt;): &lt;a href="https://supabase.com/docs/guides/functions/function-configuration" rel="noopener noreferrer"&gt;https://supabase.com/docs/guides/functions/function-configuration&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Supabase, Edge Function 401 error: &lt;a href="https://supabase.com/kb/troubleshooting/edge-function-401-error-response" rel="noopener noreferrer"&gt;https://supabase.com/kb/troubleshooting/edge-function-401-error-response&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Supabase example code: &lt;a href="https://github.com/supabase/supabase/blob/master/examples/edge-functions/supabase/functions/stripe-webhooks/index.ts" rel="noopener noreferrer"&gt;https://github.com/supabase/supabase/blob/master/examples/edge-functions/supabase/functions/stripe-webhooks/index.ts&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Stripe, Webhooks: &lt;a href="https://docs.stripe.com/webhooks" rel="noopener noreferrer"&gt;https://docs.stripe.com/webhooks&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Stripe, Verify webhook signatures: &lt;a href="https://docs.stripe.com/webhooks#verify-events" rel="noopener noreferrer"&gt;https://docs.stripe.com/webhooks#verify-events&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;More webhook fix guides from Tillping: &lt;a href="https://tillping.online/fix?ref=dev" rel="noopener noreferrer"&gt;https://tillping.online/fix?ref=dev&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Run a free check, or join the early-bird list. Only scan an address you own or are allowed to test. The free check sends safe test requests (a POST with no signature, a POST with a fake signature, and a GET), never real payment events. If your address redirects, it follows the redirect.&lt;/p&gt;

</description>
      <category>supabase</category>
      <category>stripe</category>
      <category>webhooks</category>
      <category>deno</category>
    </item>
  </channel>
</rss>
