#api
-
웰컴페이 웹훅 이중 디코딩 버그 수정으로 결제 검증 안정화
feat: 웰컴페이 에러 핸들링 및 사용자 메시지 개선 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: applica
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
feat: 웰컴페이 PENDING 충전 관리 및 잔액 동기화 기능 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type
읽기 → -
포인트 차감 순서·동시성·충전 한도 개선과 WelcomePay 기능 추가
feat: 포인트 관리 로직 업데이트 및 WelcomePay V1.6 기능 추가 포인트/잔액 관련 로직은 정합성이 핵심임. 동시성 이슈와 소수점 처리를 특히 조심해야 함. 포인트 차감 순서 무상 포인트 먼저 차감 → 부족하면 유상에서 차감 (세금 처리, 환불 정책과 연관됨) 동시성 처리 sql -- 비관적 락으로 잔액 차감 SELECT b
읽기 → -
문의하기 섹션 추가와 모바일 반응형 테이블 개선
feat: 문의하기 섹션 추가 및 UI/기능 구현 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-table-wrapper d
읽기 → -
PG 플랫폼 스토어 랜딩 페이지 반응형 UI 구현
feat: 이커머스 PG 플랫폼 스토어 UI 구현 및 헤더/푸터 추가 스토어 랜딩 페이지 UI 구현 작업임. 앱 다운로드 유도 + FAQ + 연락처 섹션으로 구성했음. 페이지 구조 [Hero Section] - 메인 카피 + CTA [Feature Cards] - 주요 기능 소개 [App Download] - App Store / Google P
읽기 → -
선물·송금 시스템 설계 문서
docs: 선물 & 송금 시스템 설계 문서 추가 및 시스템 Import 기능 구현 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture
읽기 → -
웰컴페이 서비스 계층을 정적 유틸로 전환해 구조 개선
docs: 웰컴페이 검증 항목 문서 추가 및 ServiceUtil 개선 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web)
읽기 → -
이커머스 PG 플랫폼에 주문상세·매출전표 추가
feat: 이커머스 PG 플랫폼 매출전표/주문상세 페이지 추가 및 반응형 수정 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribu
읽기 → -
주문 페이지 모바일 반응형
feat: 주문 페이지 모바일 반응형 스타일 추가 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", pr
읽기 → -
KYC 본인인증 연동
feat: PG 설정 추가 (KYC 미완성 시 Welcomepay 비활성화) KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
feat: KYC 재이행 알림 배치 작업 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: application/
읽기 → -
관심 카테고리·쿠폰 조회 기록 API 신규 추가
feat: 관심 카테고리 선택/저장 기능 및 쿠폰 조회 기록 API 추가 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md
읽기 → -
KYC 본인인증 CI/DI 연동 오류 수정과 웰컴페이 안정화
feat: KYC 본인인증 CI/DI 처리 및 웰컴페이 연동 개선 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인증 완료 후
읽기 → -
KYC 본인인증 자동화와 CI·DI 연동 오류 해결
feat: KYC 본인인증 자동 실행 및 PostMessage 기반 처리 로직 추가 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
읽기 → -
파트너 충전 한도 조회와 소속 회원 목록 기능 추가
feat: 파트너 충전 한도 및 소속 회원 목록 조회 기능 추가 포인트/잔액 관련 로직은 정합성이 핵심임. 동시성 이슈와 소수점 처리를 특히 조심해야 함. 포인트 차감 순서 무상 포인트 먼저 차감 → 부족하면 유상에서 차감 (세금 처리, 환불 정책과 연관됨) 동시성 처리 sql -- 비관적 락으로 잔액 차감 SELECT balance FR
읽기 → -
웰컴페이 KYC 본인인증 연동
feat: 웰컴페이 KYC 본인인증 연동 기능 추가 및 처리 로직 구현 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인증 완
읽기 → -
Apple OAuth 콜백 오류와 세션 유실 문제 해결
feat: Apple OAuth 설정 및 수수료 정산 로직 확장 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇 차
읽기 → -
수수료 정산 멱등성·상태 전환 로직 개선
feat: Tree 구조 추가, 수수료 정산 로직 및 탭 관리 기능 개선 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익
읽기 → -
포인트 차감 순서·동시성·파트너 수수료 정산 구조 개선
feat: 포인트/파트너 허브 메뉴 통합 및 권한 설정 개선 포인트/잔액 관련 로직은 정합성이 핵심임. 동시성 이슈와 소수점 처리를 특히 조심해야 함. 포인트 차감 순서 무상 포인트 먼저 차감 → 부족하면 유상에서 차감 (세금 처리, 환불 정책과 연관됨) 동시성 처리 sql -- 비관적 락으로 잔액 차감 SELECT balance FROM
읽기 →