📌 NestJS 백엔드 개발: 기초부터 실전까지 - NestJS 외부 API 연동 실전 가이드 (Stripe, Firebase, SendGrid)

📌 NestJS 백엔드 개발: 기초부터 실전까지 - NestJS 외부 API 연동 실전 가이드 (Stripe, Firebase, SendGrid)

현대 백엔드 서비스는 다양한 외부 API와의 통합을 필요로 합니다.
NestJS는 구조적인 아키텍처와 모듈 시스템 덕분에 Stripe, Firebase, SendGrid 등의 외부 서비스와의 연동이 매우 간편합니다.
이번 글에서는 실전에서 자주 사용되는 외부 서비스와 NestJS를 통합하는 방법을 소개합니다. 🚀

---

16.1 Stripe 연동 – 결제 시스템 구현하기

✅ Stripe 패키지 설치

npm install stripe
npm install --save-dev @types/stripe

✅ Stripe 서비스 생성

📂 libs/stripe/stripe.service.ts

import { Injectable } from '@nestjs/common';
import Stripe from 'stripe';

@Injectable()
export class StripeService {
  private stripe = new Stripe(process.env.STRIPE_SECRET_KEY, {
    apiVersion: '2023-10-16',
  });

  async createCheckoutSession(amount: number, currency = 'usd') {
    return this.stripe.checkout.sessions.create({
      payment_method_types: ['card'],
      line_items: [{
        price_data: {
          currency,
          product_data: { name: 'Test Item' },
          unit_amount: amount,
        },
        quantity: 1,
      }],
      mode: 'payment',
      success_url: 'https://yourdomain.com/success',
      cancel_url: 'https://yourdomain.com/cancel',
    });
  }
}

✅ 사용 예 (Controller)

@Controller('payments')
export class PaymentsController {
  constructor(private readonly stripeService: StripeService) {}

  @Post()
  async createPayment(@Body() body: { amount: number }) {
    const session = await this.stripeService.createCheckoutSession(body.amount);
    return { url: session.url };
  }
}

---

16.2 Firebase Admin SDK 연동 – 인증 및 푸시 알림

✅ Firebase SDK 설치

npm install firebase-admin

✅ Firebase 서비스 구성

📂 libs/firebase/firebase.service.ts

import * as admin from 'firebase-admin';
import { Injectable, OnModuleInit } from '@nestjs/common';

@Injectable()
export class FirebaseService implements OnModuleInit {
  onModuleInit() {
    admin.initializeApp({
      credential: admin.credential.cert({
        projectId: process.env.FIREBASE_PROJECT_ID,
        privateKey: process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, '\n'),
        clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
      }),
    });
  }

  async sendPushNotification(token: string, title: string, body: string) {
    return admin.messaging().send({
      token,
      notification: {
        title,
        body,
      },
    });
  }
}

✅ 사용 예 (Controller)

@Post('push')
async notify(@Body() body: { token: string, title: string, message: string }) {
  return this.firebaseService.sendPushNotification(body.token, body.title, body.message);
}

💡 인증, Firestore, Storage 등 다양한 Firebase 기능도 동일한 방식으로 사용 가능

---

16.3 SendGrid 연동 – 이메일 발송

✅ SendGrid 설치

npm install @sendgrid/mail

✅ SendGrid 서비스 구현

📂 libs/mailer/mailer.service.ts

import { Injectable } from '@nestjs/common';
import * as sgMail from '@sendgrid/mail';

@Injectable()
export class MailerService {
  constructor() {
    sgMail.setApiKey(process.env.SENDGRID_API_KEY);
  }

  async sendEmail(to: string, subject: string, html: string) {
    return sgMail.send({
      to,
      from: 'noreply@yourdomain.com',
      subject,
      html,
    });
  }
}

💡 HTML 템플릿을 활용하거나, 사용자 이름 등을 포함한 커스터마이징도 가능

---

16.4 외부 서비스 연동 시 실전 팁

✅ 환경 변수 관리는 @nestjs/config를 통해 중앙화
✅ 공통 유틸은 libs 디렉토리로 분리하고, 전역으로 모듈 등록 가능
✅ 에러 처리 시 HttpException, Logger 등을 적극 활용
✅ 인증이 필요한 API는 Retry, Timeout, Circuit Breaker 등을 도입할 것

---

16.5 결론: NestJS는 외부 서비스 연동에 강하다

✅ NestJS는 구조적으로 외부 API 연동을 모듈화하기 좋음
✅ Stripe로 결제 시스템, Firebase로 알림, SendGrid로 이메일 발송 구현
✅ 서비스별 책임을 분리하면 유지보수성과 확장성이 향상됨

다음 글에서는 NestJS의 CQRS 패턴 적용 및 마이크로서비스 아키텍처 설계를 다루겠습니다! 🚀

---

🔍 다음 글 예고: NestJS CQRS와 마이크로서비스 설계 전략

📌 다음 편: 17. NestJS CQRS 패턴 & 마이크로서비스 설계

---