Add Stripe

Step 2: Create src/config/stripe.config.ts

import { registerAs } from '@nestjs/config';

export interface StripeConfig {
  secretKey: string;
  webhookSecret: string;
  connectedWebhookSecret?: string;
}

export default registerAs(
  'stripe',
  (): StripeConfig => ({
    secretKey: process.env.STRIPE_SECRET_KEY || '',
    webhookSecret: process.env.STRIPE_WEBHOOK_SECRET || '',
    connectedWebhookSecret:
      process.env.STRIPE_CONNECTED_WEBHOOK_SECRET || undefined,
  }),
);

Step 3: Update src/config/env.validation.ts

Add before the closing });:

  /* Stripe configuration */
  STRIPE_SECRET_KEY: Joi.string().required(),
  STRIPE_WEBHOOK_SECRET: Joi.string().required(),
  STRIPE_CONNECTED_WEBHOOK_SECRET: Joi.string().optional(),

If connected account webhooks are not needed, omit the STRIPE_CONNECTED_WEBHOOK_SECRET line.

Step 4: Append to the active env file

#Stripe Credentials
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=

If connected account webhooks are needed, also add:

STRIPE_CONNECTED_WEBHOOK_SECRET=

Step 5: Enable raw body in src/main.ts

Change the NestFactory.create call to:

const app = await NestFactory.create(AppModule, { rawBody: true });

This makes req.rawBody available in webhook controllers for signature verification.

Step 6: Create the Stripe module and service

src/stripe/stripe.module.ts

Start with the base module. You will add controllers and providers to it as you go through the conditional steps.

import { Module } from '@nestjs/common';
import { StripeService } from './providers/stripe.service';

@Module({
  providers: [StripeService],
  exports: [StripeService],
})
export class StripeModule {}

src/stripe/providers/stripe.service.ts

import { StripeConfig } from '@/config/stripe.config';
import { Injectable, OnModuleInit } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import Stripe from 'stripe';

@Injectable()
export class StripeService implements OnModuleInit {
  public stripe: Stripe;

  constructor(private readonly configService: ConfigService) {}

  onModuleInit() {
    const config = this.configService.get<StripeConfig>('stripe');
    this.stripe = new Stripe(config.secretKey, {
      apiVersion: '2026-03-25.dahlia',
    });
  }
}

Step 7: Wire into src/app.module.ts

1. Add imports at the top:

import stripeConfig from './config/stripe.config';
import { StripeModule } from './stripe/stripe.module';

2. Add stripeConfig to the load array: