💳 Payment Docs클라이언트 연동 가이드

토스페이먼츠 결제 → 포인트 충전 · 조회 · 환불 API

결제 확인 (Charge)

토스페이먼츠 결제창에서 결제 완료 후 paymentKey를 서버로 전달하면 서버가 승인합니다. 클라이언트는 결제 로직 없이 paymentKey만 넘기면 됩니다.

결제 플로우 보기

충전 완료 시 유료 포인트와 무료 보너스 포인트가 자동 지급됩니다. 잔액 조회 · 사용 내역 · 환불 가능 여부를 확인할 수 있습니다.

포인트 API 보기

모든 API는 JWT Bearer 토큰 인증이 필요합니다. API Gateway가 토큰을 검증하고 사용자 ID를 내부 서비스로 전달합니다.

인증 방식 보기

모든 API는 Gateway(포트 8080) 한 곳으로 호출합니다. Rate Limiting, 인증, 라우팅이 Gateway에서 일괄 처리됩니다.

아키텍처 보기