Stripe Webhooks How to work with Stripe webhook events in development

This lesson is available for PRO members or as a single course purchase. Sign-in and choose a plan below.


*Enrollment provides full access to this course (and updates) for life.

Or Signup for Unlimited PRO Access

Install the Stripe CLI on your local system.

Trigger Webhooks Locally

Open a terminal to forward webhooks to the server.

command line
stripe listen --forward-to localhost:3333/hooks

Then open another terminal to trigger a mock webhook.

command line

stripe trigger payment_intent.created

Webhook Handler

Update the express middleware to include the body buffer.

file_type_typescript api.ts
app.use(
  express.json({
    verify: (req, res, buffer) => (req['rawBody'] = buffer),
  })
);
file_type_typescript index.ts
import { stripe } from './';
import Stripe from 'stripe';

/**
 * Business logic for specific webhook event types
 */
const webhookHandlers = {

    'payment_intent.succeeded': async (data: Stripe.PaymentIntent) => {
      // Add your business logic here
    },
    'payment_intent.payment_failed': async (data: Stripe.PaymentIntent) => {
      // Add your business logic here
    },
}

/**
 * Validate the stripe webhook secret, then call the handler for the event type
 */
export const handleStripeWebhook = async(req, res) => {
  const sig = req.headers['stripe-signature'];
  const event = stripe.webhooks.constructEvent(req['rawBody'], sig, process.env.STRIPE_WEBHOOK_SECRET);
  
  try {
    await webhookHandlers[event.type](event.data.object);
    res.send({received: true});
  } catch (err) {
    console.error(err)
    res.status(400).send(`Webhook Error: ${err.message}`);
  }
}

Q&A Chat