Next.js 15 · Prisma · Neon · Toss Payments

결제 연동을 제품처럼 완성하는 주문서와 운영 화면

토스페이먼츠 결제위젯, 서버 승인, 결제 로그, 관리자 환불 기능을 하나의 구매 경험으로 묶었습니다. 제안용 목업이지만 실제 구현 흐름을 그대로 따라갈 수 있게 구성했습니다.

서버 승인

Confirm API

결제 로그

Prisma ORM

운영 액션

Cancel API

결제위젯 주문서 구축 패키지 이미지

Featured checkout

결제위젯

위젯형

주문서 안에서 결제수단과 약관 UI를 직접 렌더링하고, 성공 리다이렉트 이후 서버가 최종 승인합니다.

server/payment-flow.ts
const widgets = tossPayments.widgets({ customerKey })
await widgets.setAmount({ value, currency: "KRW" })
await widgets.renderPaymentMethods({ selector })
await widgets.renderAgreement({ selector })

// successUrl 이후 서버에서 금액 검증
await confirmPayment({ paymentKey, orderId, amount })

Checkout widget

결제수단 UI를 직접 그리지 않습니다

토스페이먼츠 결제위젯은 결제수단과 약관 UI를 SDK가 렌더링합니다. 클라이언트는 인증만 시작하고, 서버는 저장된 주문 금액으로 최종 승인합니다.

  • Payment Widget 기본 채택
  • 서버 권위 금액 검증
  • 관리자 환불 API 연결

Live checkout

이 화면에서 바로 결제위젯을 테스트하세요

테스트 키를 사용하면 실제 과금 없이 결제 인증 흐름을 확인할 수 있습니다. 성공 URL에서는 서버가 결제 금액을 다시 검증한 뒤 승인 API를 호출합니다.

Checkout summary

결제위젯 주문서 구축 패키지

790,000

결제위젯을 준비하고 있습니다.
결제 요청 전 보안 인증