Toss 결제 서비스 만들기

가장 작은 결제 경계부터 선택하고, 호스트 앱에 필요할 때만 Nest dependency injection 또는 PostgreSQL store를 추가합니다.

먼저 선택하세요

Core 결제 서비스

앱이 framework 조합과 payment store를 직접 소유한다면 server-only core를 사용합니다.

사용 패키지: @gj-kit/toss-payments

NestJS 결제 서비스

typed provider 등록과 raw-body webhook 처리가 필요할 때 Nest 패키지를 추가합니다.

사용 패키지: @gj-kit/toss-payments, @gj-kit/toss-payments-nestjs

PostgreSQL 기반 결제 서비스

제공된 migration과 암호화 영속 구현이 필요할 때 PostgreSQL store를 추가합니다.

사용 패키지: @gj-kit/toss-payments, @gj-kit/toss-payments-postgresql

이 조합의 경계

이 가이드는 @gj-kit/toss-payments, @gj-kit/toss-payments-nestjs, @gj-kit/toss-payments-postgresql를 함께 설명하지만, 표에 표시한 경우를 제외하면 설치 의존성을 만들지 않습니다.

1. 검증부터 시작하기

서버가 실제로 소유하는 order와 payment 경계로 core kit을 만듭니다.

2. 필요할 때만 호스트 adapter 추가하기

Nest DI와 PostgreSQL store는 core 통합의 선행 조건이 아니라 확장 선택지입니다.

3. secret과 policy는 앱에 두기

key custody, 환불 정책, 앱 감사 결정은 패키지 밖에 남습니다.