실결제 장애 대응
포트폴리오
개발

실결제 장애 대응

실결제 미반영 이슈: 당일 수습과 재발 방지 테스트 체계

2026 · voidx프론트엔드 (문제 규명 · 방어 계층 · 검증 · 결제 잠금 판단)주식회사 업폴 (Upfall)26
  • Next.js
  • React
  • TanStack Query
  • Playwright
  • Vitest
  • 결제/멤버십
  • 관리자 도구
인지 당일 결제 전역 차단(4개 진입점)과 피해 사용자 환불·사과 완료
프론트엔드 사각지대 3종 실증·수정
주문 API 응답 13케이스를 오류 리졸버와 한국어·영어 16키로 매핑
결제 단위 테스트 22건에서 47건
실카드 결제·환불 시나리오 15건 통과
유료 오픈 전 백엔드 보완 사항 4건 선제 발견
조건 충족까지 3개월 결제 잠금 유지

배경

전날 외부 네트워크 행사에서 voidx 서비스가 잠재 고객에게 소개됐습니다. 회원가입 뒤 결제해 멤버십이 되면 에이전트를 체험하는 구조인데, API v2 전환이 진행 중이던 시기에 실사용자가 멤버십 결제에서 중복 승인(동일 금액 2회)과 멤버십 미활성화를 함께 겪었습니다. 사이트에는 취소·환불 동선이 없었고 결제·멤버십 백엔드는 레거시 코드와 중단된 리팩터링이 겹쳐 정상 동작하지 않는 상태였습니다. 구독 결제가 유일한 매출 경로인 서비스라 신뢰가 걸린 P0 인시던트였습니다.

결제·멤버십 백엔드는 백엔드 담당자가 구현했고 제 역할은 문제 규명과 프론트엔드 방어 계층 구축, 검증, 결제 잠금 판단이었습니다.

당일 수습: 감지 경로 확인과 결제 전역 차단

  • 알려 준 것은 사용자의 문의 메일: "첫 결제 뒤 실패 메시지가 떠 한 번 더 결제했더니 2회 실결제됐고 멤버십은 조회되지 않는다." 문의를 받은 즉시 팀에 공유했습니다. 사용자가 알려 줄 때까지 모르는 상태, 즉 감지 채널을 먼저 만드는 일을 재발 방지 1번 과제로 잡았습니다.
  • 프론트엔드에서 결제를 잠가 추가 피해 차단: 결제 파이프라인과 멤버십 백엔드가 정상 동작하지 않았고 담당자의 장기 휴가가 겹쳐 즉시 손대기 어려웠습니다. 익숙하지 않은 언어의 코드를 단기간에 정상화하기는 어렵다고 보고 백엔드를 고치는 대신 전역 결제 차단 스위치를 만들어 4개 진입점을 잠갔습니다(조회 화면은 유지). CTA를 비활성화하고 문구를 오픈 일정 안내로 바꿨습니다.
  • 피해 사용자 당일 응대: 백엔드 환불 API가 동작하지 않아 PG사 대시보드에서 직접 전액 환불하고 사과 메일로 회신했습니다.

원인 규명: 단정하지 않고 실증한 것만 수정

원인 가설을 세워 프론트엔드 사각지대 3종을 실증하고 고쳤습니다. 2xx면 응답 본문을 확인하지 않고 성공으로 넘기던 판정, 본문 없는 204 응답에서 화면이 멈추던 문제, 결제 뒤 멤버십 활성화를 확인하지 않던 흐름입니다. 서버측 멱등키 처리가 비어 있던 점은 이와 별도로 발견했습니다.

근본 원인은 끝까지 하나로 확정하지 못했습니다. 구조적 배경으로는 대형 CMS 기준으로 기획된 권한·멤버십 구조가 제품 방향이 바뀌는 동안 정리되지 못한 채 덧붙여지기만 한 점이 있었습니다. 확정하지 못한 것을 확정한 것처럼 적지 않고 실증한 수정과 남은 의문을 나눠 기록했습니다.

운영 안전장치: 해제 조건이 붙은 킬스위치와 에러 계약 고정

  • 잠금을 해제 조건이 붙은 게이트로 설계: 임시방편으로 두지 않았습니다. "백엔드 중복 방지 처리와 보상 트랜잭션 배포 완료"를 선결 조건으로 문서에 못 박고 환경 플래그로 잠금을 제어하되 기본값이 잠금이 되도록 뒀습니다. 인시던트 때 코드 배포 없이 결제 CTA를 즉시 잠그면서 실수 커밋 한 번으로 차단이 조용히 풀리는 경로까지 막았습니다.
  • 오류 응답 전수 매핑과 테스트 고정: 백엔드 원문 오류와 내부 API 경로가 사용자 화면에 그대로 노출되던 것을, 주문 API 응답 13개 케이스를 오류 리졸버와 한국어·영어 메시지 16키로 매핑하고 테스트 47건으로 고정해 지웠습니다. 판정은 HTTP 상태 코드만 보던 것에서 응답 본문의 코드와 데이터까지 확인하도록 바꾸고 204 처리는 공통 응답 처리 계층에서 일괄 정리했습니다.
  • e2e 실행 환경 자체를 안전하게 설계: 결제처럼 되돌리기 어려운 흐름의 e2e는 기존 dev 서버 재사용을 금지(reuseExistingServer: false)해 프로덕션 API를 바라보는 서버에서 탈퇴·결제 시나리오가 실행되는 사고를 막고 백엔드 rate limit을 공유하는 시나리오는 직렬(worker 1개)로 실행하며 setup·journeys·locale 3프로젝트로 나눴습니다.

재개 판단: 실카드 15건 검증과 3개월 잠금

백엔드에 중복 방지 키가 들어온 뒤에는 코드를 직접 읽어 확인한 다음 결제 흐름에 연결하고 실카드 결제·환불 15개 시나리오로 결제 성공만이 아니라 해지·재개·환불까지 왕복을 검증했습니다. 재청구가 없는지, 환불이 중복되지 않는지, 타인 결제가 403으로 막히는지를 통과 기준에 넣었습니다.

서버측 멱등 처리(백엔드 구현)와 검증이 갖춰질 때까지 3개월간 결제 잠금을 유지했습니다. 매출 경로를 닫아 두는 결정이라 압박이 있었지만 확신이 없는 상태로 여는 쪽이 더 비쌌습니다.

결과

  • 당일: 결제 전역 차단(4개 진입점), 피해 사용자 전액 환불·사과 완료
  • 프론트엔드 사각지대 3종 실증·수정: 2xx 본문 미검증 · 204 화면 중단 · 멤버십 활성화 미확인
  • 13개 케이스 → 16키: 주문 API 응답을 오류 리졸버와 한국어·영어 메시지로 전수 매핑
  • 22건 → 47건: 결제 관련 단위 테스트
  • 15건: 실카드 시나리오 검증 통과 (재청구 없음 · 환불 중복 없음 · 타인 결제 403 차단 포함)
  • 4건: 유료 오픈 전 선제 발견한 백엔드 보완 사항
  • 3개월: 조건 충족까지 결제 잠금 유지

정리

이 건을 코드만의 문제로 보지 않고 정책의 문제로 함께 봤습니다. 리팩터링을 하려면 먼저 유즈케이스 기획이 정해져야 하고 그 뼈대가 될 현 시점 기준의 권한·멤버십·유료 정책이 필요하다는 점을 담당자에게 팔로우업했습니다. 그리고 다음 인시던트는 사용자가 알려 주기 전에 우리가 먼저 알아야 한다는 것, 감지 채널을 만드는 일이 재발 방지의 첫 과제라는 것을 확인한 케이스입니다.