#payment
-
패키지 구조 재편과 Service를 Util로 전환한 리팩토링 가이드
docs: 패키지 구조 및 Mapper XML 위치 규칙 문서화 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web)와 Ut
읽기 → -
키움페이 결제 취소 샘플 추가
feat: 키움페이 결제 취소 샘플 추가 및 UI/본인확인 로직 개선 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("o
읽기 → -
디자인 토큰 통일과 모바일 스크롤 스냅으로 CSS 일관성 개선
docs: AI 서비스 및 스타일 가이드 문서 제거 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CSS 변수로 통일함. scss :root
읽기 → -
수수료 정산 구조·멱등성·검증 방법 문서 삭제
docs: 수수료 구현 및 검증 문서 삭제 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |------|------|
읽기 → -
상품 주문 결제 트랜잭션 원자성 보장
feat: 구독 관리 기능 및 결제 처리 로직 구현 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", p
읽기 → -
웰컴페이 API 레퍼런스 문서 체계 정비
docs: 웰컴페이 API 서비스 명세서 V1.6 추가 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md 시스템 구
읽기 → -
웰컴페이 KYC 본인인증 연동
feat: 웰컴페이 PostMessage 공통 유틸리티 도입 및 중복 코드 제거 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK →
읽기 → -
PG 결제 라우팅과 주문 트랜잭션 원자성 확보
feat: PG 결제 라우터 추가 및 시스템 ID 기반 PG 라우팅 구현 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute(
읽기 → -
주문 결제 트랜잭션 정합성 개선
feat: 주문 결제 트랜잭션 정합성 수정 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", produc
읽기 → -
결제 도메인 완성하고 퇴사한 달의 기록
278개. 2월 커밋 수. 역대 최고치를 경신했다. 이전 회사 마지막 달이기도 했다.
읽기 → -
웰컴페이 웹훅 이중 디코딩 버그 수정으로 결제 검증 안정화
feat: 웰컴페이 에러 핸들링 및 사용자 메시지 개선 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: applica
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
feat: 웰컴페이 PENDING 충전 관리 및 잔액 동기화 기능 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type
읽기 → -
선물·송금 시스템 설계 문서
docs: 선물 & 송금 시스템 설계 문서 추가 및 시스템 Import 기능 구현 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture
읽기 → -
웰컴페이 서비스 계층을 정적 유틸로 전환해 구조 개선
docs: 웰컴페이 검증 항목 문서 추가 및 ServiceUtil 개선 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web)
읽기 → -
결제 알림 채널별 발송
fix: Welcome Payments 스펙 개선 및 PUSH NOTI 처리 기능 추가 알림 시스템 구현 작업임. 거래 이벤트마다 적절한 채널로 알림을 발송하는 구조를 잡았음. 알림 채널 | 채널 | 용도 | 특징 | |------|------|------| | 앱 PUSH | 실시간 거래 알림 | FCM 사용 | | SMS | 중요 인증/보안 |
읽기 → -
웰컴페이 회원 탈퇴 시 관리자 식별자 조회 로직 보완
fix: 웰컴페이 회원 탈퇴 로직 보완 (mgtId 조회 로직 추가) 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 1개 | 핵심 처리 로직
읽기 → -
결제 Webhook 이중 URL 디코딩 버그 수정으로 시그니처 검증 안정화
docs: 웰컴페이 Webhook 및 ServiceUtil 관련 내용 업데이트 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-
읽기 → -
KYC 본인인증 CI/DI 연동 오류 수정과 웰컴페이 안정화
feat: KYC 본인인증 CI/DI 처리 및 웰컴페이 연동 개선 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인증 완료 후
읽기 → -
KYC 본인인증 연동
feat: 웰컴페이 회원 상태 조회/변경 기능 및 PostMessage 처리 개선 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK
읽기 → -
Apple 소셜 로그인 콜백 세션 유실
fix(oauth): Apple 연동 후 로그인 세션 재설정 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇 차단
읽기 →