#payment
-
결제 콜백 후 잔액 즉시 반영
결제 콜백 후 잔액이 안 보이던 문제 결제대행사 콜백이 들어와서 충전이 끝났는데, 정작 파트너 화면에서 새 잔액을 보려면 새로고침을 두세 번 해야 했음. 콜백 처리 자체는 멀쩡한데 후처리 흐름이 어긋난 것. 원인을 까보니: - 콜백 트랜잭션 커밋 직후 응답을 돌려주는데, 조회 API 쪽이 자체 캐시를 들고 있었음 - 잔액 반영 이벤트가 비동기로 흐르
읽기 → -
결제 웹훅 중복 처리를 멱등성 락으로 차단
결제대행사 Webhook이 같은 건을 두 번 때리는 문제 운영 중 결제대행사에서 같은 결제 건에 대해 동일한 웹훅이 두 번, 세 번 들어오는 케이스가 누적됨. 첫 호출에서 정상 처리됐는데 두 번째 호출이 잔액을 한 번 더 건드리거나 알림이 중복 발송되는 사고가 발생했음. 원인을 정리하면 이런 흐름이었음. - 결제대행사가 응답 ACK를 못 받으면 일정
읽기 → -
결제대행사 웹훅 멱등 처리와 명세 불일치 극복기
결제대행사 API 연동, 명세서부터 다시 읽음 결제대행사 연동 작업 들어가면서 받아둔 명세서 PDF를 처음부터 다시 정독함. 이전에 한 번 훑었을 때는 "어차피 표준 PG 흐름이지" 싶어서 대충 봤는데, 막상 코드로 옮기려니까 필드 단위에서 막히는 부분이 한둘이 아니었음. 특히 헷갈렸던 포인트: - 승인 응답과 webhook 통보 메시지의 필드 이름
읽기 → -
출금 실패 알림과 포인트 조회 오류 동시 수정
출금 실패 복구에 긴급 알림 붙임 결제대행사 webhook 처리 중 출금 실패가 났을 때, 자동 복구는 돌아가는데 운영자가 모르고 지나가는 사고가 있었음. 새벽에 터지면 다음날 아침에 발견해서 정산 마감 직전에 허둥대는 패턴이 반복됨. 복구 자체보다 **인지 지연**이 진짜 리스크라는 걸 늦게 깨달음. 알림 분기를 단순하게 잡았음. | 트리거 | 채
읽기 → -
연락처 송금 결제수단 추가로 콜백과 매칭 로직 전면 재작성
연락처 송금이 결제수단으로 들어왔을 때 이커머스 결제 흐름에 새 결제수단이 하나 끼어들었음. 기존 카드/가상계좌/포인트 옆에 "연락처 송금"이 들어오는 작업. 처음엔 단순히 결제수단 enum 하나 늘리는 줄 알았는데, 까보니 매칭 로직이 본체였음. 매칭이 진짜 일이었음 연락처 기반이라 "보낸 사람 번호"와 "받을 사람 번호"가 정확히 매핑돼야 함
읽기 → -
은행별 입금 감시 오류 분류와 멱등성으로 이중 처리 방지
입금 감시 로직, 은행마다 다르게 터지는 게 문제였음 여러 은행 핸들러에서 입금 완료 감시 로직이 들쭉날쭉이라 정리한 회고. 같은 "입금 확인"인데 은행별로 응답 포맷, 타임아웃 패턴, 에러코드가 다 달라서 분기마다 한 번씩 장애가 났음. 무엇이 문제였나 기존 구조는 각 은행 핸들러가 자기 방식대로 예외를 던지고, 상위 스케줄러는 그걸 단순히 ca
읽기 → -
쿠폰 허용 결제수단 표시
feat: 쿠폰 허용 결제수단 표시 및 토글 UI 개선 기능 구현.
읽기 → -
결제 모니터 관련 문서를 실제 구현에 맞게 동기화
docs: TODO.md 업데이트 - pay-monitor 관련 기능 추가 문서 업데이트.
읽기 → -
README 정비로 팀 문서화 기준 확립
README.md 추가 문서 작업은 다들 대충 하고 넘어가는데 나중에 후회함. README를 제대로 정리하면서 프로젝트 구조도 같이 다시 봤음. README에 반드시 들어가야 할 것들 markdown 프로젝트 개요 어떤 문제를 해결하는지 1-2줄로 설치 방법 복붙 가능한 명령어 위주로 환경 변수 | 키 | 설명 | 필수 여부 | 아키텍
읽기 → -
결제 웹훅 이중 URL 디코딩 버그 수정으로 서명 검증 안정화
fix: 포인트소멸/사용자출금 Webhook도 이중 URL decode 버그 수정 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Conten
읽기 → -
가상계좌 웹훅 암호화 필드 이중 디코딩 버그 수정
fix: VBANK_CHARGE Webhook 암호화 필드 이중 URL decode 버그 수정 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가
읽기 → -
결제 웹훅 이중 URL 디코딩으로 인한 시그니처 검증 오류 수정
fix: VBANK_CHARGE Webhook 시그니처 검증 시 URL-encoded trstnId를 primary로 변경 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태
읽기 → -
결제 Webhook 이중 디코딩 버그 수정으로 검증 안정화
feat: Webhook 검증 로직 개선 및 스토어 FAQ 다국어 지원 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-T
읽기 → -
결제 Webhook 이중 디코딩 버그 수정으로 검증 오류 해결
feat: 스토어 페이지 다국어 지원 및 Webhook 디코딩 로직 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Typ
읽기 → -
스토어 랜딩 페이지 반응형 레이아웃
style: 스토어 관련 CSS/SCSS 스타일 및 JSP 구조 개선 스토어 랜딩 페이지 UI 구현 작업임. 앱 다운로드 유도 + FAQ + 연락처 섹션으로 구성했음. 페이지 구조 [Hero Section] - 메인 카피 + CTA [Feature Cards] - 주요 기능 소개 [App Download] - App Store / Google P
읽기 → -
결제 트랜잭션에 재고·포인트·알림을 원자적으로 묶어 안전성 확보
feat: 법적 확인 모달 및 결제 관련 UI/UX 추가 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options"
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
feat: 지갑 및 결제 관련 주요 기능 추가 및 개선 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: applica
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
docs: Webhook API 가이드 v1.3 업데이트 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: applic
읽기 → -
결제 Webhook 이중 디코딩 버그 수정으로 시그니처 검증 안정화
docs: Webhook API 가이드 수정 (trstnId 평문 기준으로 변경) Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Conten
읽기 → -
키움페이 Webhook 이중 디코딩 버그 수정으로 결제 검증 안정화
feat: 스토어 테마 등록 및 키움페이 Webhook 연동 가이드 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Typ
읽기 →