이커머스 푸터 선불 잔액 보호 고지 문구 갱신

이커머스 PG 플랫폼의 푸터에 선불 잔액 보호 고지 문구를 갱신했다. 커밋 diff 한 줄만 보면 텍스트 상수 하나 바꾼 것처럼 보이지만, 이 변경 뒤에는 규제 요건, 사용자 보호, 법적 책임이라는 꽤 무거운 맥락이 깔려 있다.

선불금 고지를 가볍게 보면 안 되는 이유

선불 잔액이나 포인트처럼 사용자 돈을 미리 받아 플랫폼이 보관하는 구조는, 금융감독 입장에서 사실상 선불전자지급수단에 준하는 민감한 영역이다. 충전한 돈이 어떻게 관리되는지, 환불 요건은 뭔지, 장기 미사용 시 소멸되는지 같은 정보가 명확하게 공개되지 않으면 소비자 보호법이나 전자금융거래법상 위반 소지가 생긴다.

이번 갱신 이유는 크게 네 가지 중 하나였을 것이다.

• 규제 기관의 새 지침이나 권고사항 반영
• 서비스 정책 변경에 따른 고지 내용 업데이트
• 기존 문구가 불충분하다는 법무 판단
• 모호한 표현을 더 명확하게 다듬는 작업

어느 쪽이든 공통점은 하나다. 법무나 컴플라이언스팀이 먼저 움직이고, 개발은 그 결과물을 화면에 얹는 역할이라는 것. 그러니 이런 티켓은 요건 자체보다 "어떤 표현을, 어떤 위치에, 어떤 크기로" 붙이느냐가 더 핵심이 됨. 법무 확인본 텍스트를 개발자가 임의로 줄이거나 손대는 건 금물이다. 글자 하나 바꿨다가 나중에 감사 증적에서 걸릴 수 있기 때문이다.

푸터라는 공간의 전략적 위치

기술적으로 보면 이번 수정 대상은 JSP 파일 안의 공통 푸터 컴포넌트다. 서비스 전체 페이지에 include로 박혀 있어서 한 파일 고치면 전 페이지에 반영됨. 단순하다면 단순한 구조인데, 그래서 오히려 영향 범위가 크다.

푸터는 전략적으로도 중요한 자리다. 약관, 개인정보처리방침, 이용안내 같은 정책 문서 링크가 모이는 곳이고, 법적 고지를 상시 노출해야 하는 위치 중 하나다. WCAG 2.1 기준으로 보면 텍스트 대비율 4.5:1 이상, 클릭 타겟 최소 44×44px 확보, 글자 크기 12px 이상이 권장사항이다. 법적 고지 문구가 너무 작거나 회색으로 묻혀 있으면 "공개했다"는 주장 자체가 흔들릴 수 있다.

코드 레벨에서 자주 보이는 패턴은 고지 문구를 JSP에 하드코딩하지 않고 별도 프로퍼티 파일이나 설정으로 뽑아 두는 것이다. 배포 없이 문구만 바꿀 수 있게 분리해 두면 다음 번 갱신이 훨씬 편해짐.

<%-- footer.jsp ---%>
<div class="footer-notice">
  <p class="prepaid-notice">${fn:escapeXml(noticeMessage)}</p>
  <%-- noticeMessage는 messages.properties 또는 DB 설정에서 주입 --%>
</div>

# messages_ko.properties
footer.prepaid.notice=선불 잔액은 관련 법령에 따라 보호됩니다. 자세한 내용은 이용약관을 확인하세요.

이렇게 분리해 두면 법무팀이 문구를 확정한 다음 바로 반영할 수 있고, 소스 코드 리뷰 없이도 변경 이력 추적이 가능하다. 텍스트를 JSP 안에 직접 박아 두면 다음 담당자가 "이 문구가 어디서 나오는 거지?" 하고 한참 찾아 헤매는 상황이 생긴다.

배포 전에 빠뜨리기 쉬운 체크포인트

공통 컴포넌트 수정이다 보니 QA 범위가 넓어진다. 커밋 메시지에는 드러나지 않지만, 실제 배포까지 가는 과정에서 챙겨야 할 것들이 있다.

• 문구가 길어졌을 때 푸터 높이 변화 확인 - 레이아웃 밀림이 생기면 하단 버튼이나 배너가 겹칠 수 있음
• 모바일 320px 폭 기준 줄바꿈이 자연스러운지
• 다국어 버전 있으면 각 locale 파일 동시 반영 여부
• IE11 포함 구형 브라우저에서 렌더링 깨짐 없는지
• 스크린리더로 고지 문구가 의미 있게 읽히는지 - aria-label이나 role 속성이 빠져 있으면 보완 필요
• 법무팀 최종 확인본과 배포본 텍스트 1:1 대조

특히 마지막 항목을 배포 직전에 한 번 더 확인하는 습관이 필요하다. 개발 과정에서 복붙 실수나 인코딩 문제로 글자 하나 빠지는 일이 생각보다 자주 있었음. 규제 관련 문구는 "비슷하게 맞는 것"이 아니라 "정확히 일치해야 하는" 영역이다. 한 번의 실수가 컴플라이언스 이슈로 번질 수 있다.

커밋 메시지에는 파일명 하나만 남지만, 실제 배포까지 가는 과정에는 법무 검토, QA 범위 정의, 다국어 대응, 접근성 확인이 쌓여 있다. 텍스트 한 줄 바꾸는 작업에 이만큼의 맥락이 붙는 게 이커머스 PG 플랫폼의 현실이다. 귀찮기도 하고, 동시에 이 일이 단순 코딩이 아니라는 걸 체감하게 해주는 부분이기도 하다.