결제 검증 로직 포함Next.js 16 · Tailwind CSS 4 · TypeScript
토스페이먼츠 결제와 Firebase Auth가
이미 연결된 상태로 시작하세요.
결제 검증, 보안 규칙, 관리자 대시보드까지 — 한국 시장에 SaaS나 디지털 프로덕트를 팔 때마다 매번 새로 짜야 했던 기반 코드를 미리 준비해뒀습니다.
src/app/api/toss/confirm/route.tsPASS
// 결제 승인 직전 — 서버가 가격을 재검증한다
- const amount = req.body.amount
+ const amount = await getAuthoritativePrice(planId)
// 재조회한 값과 다르면 즉시 거부
if (amount !== approvedAmount) return reject()
✓ Idempotency-Key로 중복 승인 방지
포함된 것
01
토스페이먼츠 결제 흐름
클라이언트가 보낸 가격은 절대 신뢰하지 않고, 서버가 Firestore 원가를 재조회해 결제 금액을 검증합니다. Idempotency-Key로 중복 승인도 막습니다.
02
Firebase Auth
이메일/비밀번호 로그인이 기본, Google 로그인도 바로 켜져 있습니다. 카카오 로그인은 README에 연동 가이드로 제공합니다.
03
Firestore 보안 규칙
가격 플랜은 누구나 읽고 관리자만 쓸 수 있고, 결제 레코드는 최소 스키마 검증을 통과해야 생성됩니다.
04
관리자 대시보드
로그인으로 보호된 /admin에서 매출 통계와 결제 내역을 확인하고, 가격 플랜을 코드 수정 없이 등록/수정할 수 있습니다.
데모 가격 플랜
아래 플랜은 예시 데이터입니다 (Firestore 미설정 시 FALLBACK_PLANS). /admin에서 실제 판매할 플랜으로 교체하세요.