
SOFTMOA PROJECTS
결제·간편결제 연동 — 이니시스·카카오페이·네이버페이 주문 처리
구축 배경과 구현 범위를 확인해보세요.
Contents
프로젝트 개요
주문 생성, 결제 요청, 결과 확인과 취소·부분취소, PG 정산 대사를 연결하는 이니시스·카카오페이·네이버페이·토스페이먼츠 결제 연동입니다.
운영자는 결제 내역과 처리 결과를 조회하고, 부분취소를 처리하며, PG사 정산 금액과 내부 거래를 일자별로 대사합니다.

주요 기능
결제 처리
- 주문 번호·상품·금액 기반 결제 요청
- 결제 결과·웹훅 수신과 주문 상태 반영
- 카드·간편결제·계좌이체 결제수단
취소·환불
- 전체·부분취소와 잔여 결제금액 계산
- 결제 이력 타임라인과 PG 응답 확인
정산·대사
- PG사별 승인·취소·수수료·정산 예정액
- 실제 입금액과의 차이 확인
- 불일치 거래 원인 추적

기술 구성
| 구분 | 사양 |
|---|---|
| Backend | Kotlin 2.4 · Spring Boot 4.1 · JDK 25 |
| Frontend | Next.js 16 · React 19 · TypeScript |
| Data | PostgreSQL 18 · jOOQ · Flyway |
| 결제 연동 | KG이니시스 · 카카오페이 · 네이버페이 · 토스페이먼츠 API |
구현 포인트
- 서버에 저장한 주문 금액과 결제 결과를 대조한 뒤 주문 상태 변경
- 동일 결과의 중복 수신에 대비해 거래 식별자와 처리 여부 검증
- 부분취소 금액은 품목·할인·배송비를 반영해 서버에서 계산
- 결제사별 요청·응답 변환과 주문 업무 로직을 분리해 결제 수단을 추가할 때 기존 규칙 재사용

업무에 주는 가치
결제 결과를 서버에서 다시 검증해 금액 위변조와 중복 처리로 인한 사고를 막습니다.
부분취소 금액이 자동 계산되어 고객 응대 중에도 정확하게 환불을 처리합니다.
PG 정산과 내부 거래를 일자별로 대사해 입금 차이를 빠르게 찾고 정산 마감을 앞당깁니다.
Share this
포트폴리오
Showing 1 to 10 of 60 entries
