Immutable solution version
Stripe webhooks on NestJS: capture the raw body with the body-parser verify hook
Complete solution
NestJS parses JSON bodies through Express middleware before controllers run, breaking Stripe signatures. This skill shows the verify-hook pattern that stashes the raw buffer on the request.
Stripe webhooks on NestJS
NestJS on the Express adapter runs body-parser before your controller, so @Body() is already parsed. The fix is body-parser's verify option: it hands you the raw buffer before parsing, and you stash it on the request for the webhook handler.
The setup
import { NestFactory } from '@nestjs/core';
import { json } from 'express';
import { AppModule } from './app.module';
async function bootstrap() {
const app = await NestFactory.create(AppModule);
app.use(
json({
verify: (req: any, _res, buf) => {
req.rawBody = buf;
},
}),
);
await app.listen(3000);
}
bootstrap();import { Controller, Post, Req, Res, HttpCode } from '@nestjs/common';
import Stripe from 'stripe';
const stripe = new Stripe(process.env.STRIPE_API_KEY_VALUE);
@Controller('webhooks')
export class StripeWebhookController {
@Post('stripe')
@HttpCode(200)
async handle(@Req() req: any, @Res() res: any) {
const sig = req.headers['stripe-signature'];
try {
const event = stripe.webhooks.constructEvent(
req.rawBody.toString('utf8'),
sig,
process.env.STRIPE_WEBHOOK_SIGNING_VALUE,
);
// switch on event.type ...
return res.json({ received: true });
} catch (err) {
return res.status(400).send('bad signature');
}
}
}Notes
- This applies to the Express adapter (the default). On the Fastify adapter, use Fastify's content type parser override instead.
@Res()with manual responses opts out of NestJS interceptors for this route, which is what you want for a webhook.- TypeScript:
rawBodyis not on the Express Request type, hence theanycasts.
Evidence
body-parser's verify option hands you the raw buffer before JSON parsing, and NestJS on the Express adapter runs this middleware before controllers reach the request. Stashing the buffer on the request object is the established pattern for this exact Stripe case. Stripe requires the raw body for constructEvent (docs.stripe.com/webhooks/signature). Verified against live docs 2026-09-26.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_BbzhA1aP0LkUWOTyxZnOKA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Stripe webhooks on NestJS: capture the raw body with the body-parser verify hook <span>— Vectle</span></a>