플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - KG이니시스 망취소 시나리오에서 주문 상태와 재고를 원자적으로 롤백하는 트랜잭션 설계 - PC 팝업과 모바일 리다이렉트 환경에서 결제 완료 콜백을 동일한 엔드포인트로 수렴시키는 흐름 통일 - PASS 콜백 수신 시점에 세션이 만료된 경우 사용자 인증 상태를 안전하게 복원하는 처리 - 테스트 환경 API 키와 상용 API 키를 코드 수정 없이 전환할 수 있는 환경 설정
프로젝트 성과
KG이니시스·PASS 이중 외부 API 통합 구조 설계
결제 PG와 통신사 본인인증 두 외부 API를 단일 FastAPI 서버에 통합하고, 각 콜백 흐름을 비동기 파이프라인으로 구성하는 아키텍처를 설계할 예정입니다.
AES-256 기반 개인정보 암호화 파이프라인 구현
PASS 콜백으로 수신하는 이름·생년월일·전화번호를 AES-256-CBC로 복호화 후 마스킹 처리해 DB에 안전하게 저장하는 보안 파이프라인을 구현할 예정입니다.
멱등성 키 기반 웹훅 중복 처리 방지 로직 구현
결제 망취소 및 재전송 케이스에서 동일 웹훅을 복수 처리하지 않도록 멱등성 키 검증과 DB 유니크 제약을 조합한 구조를 적용할 예정입니다.
PC/모바일 환경 자동 분기 결제창 호출 구현
userAgent 감지를 통해 웹표준 팝업 방식과 모바일 리다이렉트 방식을 자동으로 선택하는 분기 로직을 React·백엔드 양측에 구현할 예정입니다.
핵심 기능
PASS 본인인증 연동
통신사 PASS API를 활용한 사용자 신원 검증 화면
진행 단계
PG·인증 API 사양 분석
2026.04
KG이니시스 매뉴얼 및 PASS API 스펙 분석, 암호화 요구사항 정리
프로젝트 상세
1) 포트폴리오 소개 KG이니시스 PG 결제와 통신사 PASS 본인인증을 React + FastAPI 기반 웹서비스에 통합하는 데모 구현입니다. 결제 요청부터 승인·웹훅 콜백까지의 전 흐름을 하나의 플로우로 설계하며, 개인정보 AES 암호화 및 트랜잭션 무결성 보장 구조를 적용할 예정입니다. 2) 작업 범위 - PASS 본인인증 연동: 통신사 PASS API를 활용한 사용자 신원 검증 화면 - KG
