구독킷

SaaS 기업을 위한 구독결제 솔루션 문서

구독킷 소개

구독킷은 구독 결제 시스템 구축의 복잡성을 해결하는 완전한 턴키 솔루션입니다. 기존 서비스에 영향을 주지 않고도 빠르게 구독 결제를 도입할 수 있도록 설계된 독립적인 시스템입니다.

이럴 때 구독킷이 필요합니다

새로운 구독 모델을 실험하고 싶은 경우

기존 일회성 구매 모델에서 구독 모델로 전환을 고려 중이신가요?
다양한 구독 플랜과 가격 정책을 실험해보고 싶으신가요?
무료 체험이나 프리미엄 모델을 도입하고 싶으신가요?

구독 결제 시스템 구축에 어려움을 겪는 경우

결제 모듈 연동과 정기결제 구현이 부담되시나요?
구독 상태 관리와 자동화된 결제 처리가 필요하신가요?
결제 실패와 재시도 처리를 자동화하고 싶으신가요?

구독 관리의 효율화가 필요한 경우

구독자 증가로 수작업 관리가 어려워지고 있나요?
미수금 관리와 연체 처리에 많은 시간을 쏟고 계신가요?
구독 현황과 매출을 실시간으로 파악하고 싶으신가요?

고객 경험을 개선하고 싶은 경우

결제 실패시 자동 알림이 필요하신가요?
고객이 직접 구독을 관리할 수 있는 기능이 필요하신가요?
다양한 할인과 프로모션을 운영하고 싶으신가요?

주요 기능

구독 관리

구독 목록 관리
전체 구독 현황 모니터링
구독 상태별 필터링 및 검색
구독 정보 상세 조회
구독 상태 관리
구독 상태 변경 및 이력 관리
체험/활성/연체/취소 등 상태 자동화
구독 취소 및 환불 처리

결제 관리

결제 내역
전체 결제 트랜잭션 조회
결제 상태별 필터링
결제 실패 시 재시도 처리
인보이스 관리
인보이스 자동 생성
PDF 출력 및 이메일 발송
미수금 관리 및 추적

세금계산서는 자동으로 발행되며, 매출 신고를 위한 통계 데이터도 제공됩니다.

시작하기

설치

환경변수 설정

cp .env.example .env.local

의존성 설치

pnpm install

데이터베이스 마이그레이션

pnpm db:push

개발 서버 실행

pnpm dev

필수 환경변수

# 데이터베이스
DATABASE_URL=postgresql://username:password@localhost:5432/subscriptionkit
 
# 결제모듈
NEXT_PUBLIC_NICE_PAY_CLIENT_KEY=your-client-key
NICE_PAY_SECRET_KEY=your-secret-key
NICE_PAY_API_URL=https://api.nicepay.co.kr
 
# 보안
SUBSCRIPTION_SECRET_KEY=your-secret-key

배포 인프라

구독킷은 다음과 같은 무료 인프라를 활용할 수 있습니다:

Vercel (Hobby Plan)

Next.js 애플리케이션 호스팅
월 100만 요청까지 무료
Git 연동을 통한 자동 배포

MAU 5만명까지 완전 무료로 운영 가능합니다.

Trigger.dev (Free Plan)

구독 갱신 및 결제 처리 자동화
실시간 모니터링 및 알림
최대 10개 동시 실행

데이터베이스 선택

Neon Tech (Free Plan)
- PostgreSQL 데이터베이스
- 500MB 스토리지
- 자동 스케일링
Supabase (Free Plan)
- PostgreSQL + 추가 기능
- 실시간 데이터베이스
- 내장 인증 시스템

본 문서의 내용은 예시이며, 실제 서비스와 다를 수 있습니다.

Next

요금제 관리