배경과 과제
배경
결제 흐름은 모든 계약에서 같지 않았습니다. 상품 구성에 따라 중도금이 생략될 수 있었고, 드레스샵 확정 여부에 따라 예정 금액과 결제 가능 상태가 달라졌습니다. 추가 상품도 구매한 시점에 따라 진행 중인 결제 일정에 포함하거나 별도 결제로 처리해야 했습니다.
업체, 옵션, 추가 상품, 쿠폰과 포인트 같은 선택은 서버에 저장되기 전에도 예상 금액과 현재 가능한 행동에 반영돼야 했습니다.
핵심 과제
계약 구성과 결제 이력을 바탕으로 사용자가 지금 확인해야 할 결제 단계, 금액과 가능한 행동을 한 화면에서 일관되게 계산해야 했습니다.
설계 시 고려한 점
- 업체와 옵션, 드레스샵 후보에 따라 중도금과 잔금 예정액이 달라졌고, 추가 상품, 쿠폰과 포인트가 바뀔 때마다 다시 계산해야 했습니다.
- 사용자 추가구매와 운영자의 계약 변경이 서로 다른 경로로 상품에 반영됐습니다. 결제가 진행된 뒤에는 현재 계약만 다시 계산하지 않고 기존 납부 이력과 새 미결제 금액을 함께 해석해야 했습니다.
- 가상계좌 입금 대기와 결제 실패처럼 즉시 완료되지 않는 상태도 다음 단계와 결제 버튼에 반영해야 했습니다.
운영 제약
- 이미 운영 중인 과거 계약과 신규 정책을 함께 지원해야 했기 때문에 기존 데이터를 일괄 변경하거나 결제 흐름을 전면 교체하기 어려웠습니다.
- 기존 결제 API와 PG 연동을 유지해야 했으며 최종 결제 요청과 금액 검증은 서버 결과를 기준으로 해야 했습니다.
- 반면 드레스샵 후보와 추가 상품처럼 확정 전 선택은 서버에 저장되기 전에도 화면에 반영돼야 했기 때문에, 프론트에서 예정 금액을 계산한 뒤 서버 결과와 맞춰야 했습니다.
결제 규칙과 상태 흐름
결제 상태에 따라 달라지는 추가 상품 반영 방식
스튜디오 상품 포함 여부에 따라 중도금 경로가 갈라졌습니다. 드레스샵 후보가 있는 경우에는 샵 확정 여부에 따라 예정 금액과 결제 가능 상태가 달라졌습니다.
구현 및 운영 결과
- 사용자
- 현재 결제 단계와 금액, 다음 행동을 한 화면에서 확인하고 계약 변경 후에도 기존 납부액과 새 미결제액을 구분해 볼 수 있게 했습니다.
- 운영
- 과거 계약 데이터를 일괄 변경하지 않고 기존 계약과 신규 결제 정책을 함께 운영할 수 있게 했습니다.
- 안전성
- 화면에서 예상 금액을 즉시 보여주되 실제 결제 금액은 서버가 다시 검증하도록 해 계산 오류가 결제로 이어지지 않게 했습니다.
핵심 구현과 판단
1. 여러 결제 상태를 하나의 현재 단계로 변환
서버는 다음 결제 종류와 계약금, 중도금, 잔금의 납부 상태를 각각 내려줬습니다. 프론트는 이 값에 상품과 결제 이력을 조합해 사용자가 지금 확인할 계약금, 중도금, 잔금, 추가 구매, 완납 상태를 계산했습니다.
- 계약이 변경된 뒤에는 현재 상품 구성만 보지 않고 실제 납부액을 우선해 이미 완료된 중도금과 잔금 이력이 사라지지 않도록 했습니다.
- 숫자 상태, 미결제 상품과 결제 이력을 조합해 상품 종류와 기존 납부액을 확인했습니다.
2. 업체와 옵션 가격을 조합해 화면용 예상 금액 계산
프론트는 서버에서 조회한 업체와 옵션 가격을 바탕으로, 아직 확정되지 않은 선택 조합의 예상 금액을 계산했습니다. 드레스샵 후보별 가격 차이와 추가 상품, 수량, 쿠폰, 포인트를 반영해 중도금과 잔금 예정액을 즉시 갱신했습니다. 실제 결제 요청에서는 서버가 최종 금액을 다시 검증했습니다.
- 가격 정책이 서버와 프론트에 나뉘어 있어 정책이 바뀌면 두 계산 결과가 달라질 위험이 남았습니다.
3. 추가 상품을 구매한 시점에 따라 반영할 결제 단계 결정
추가 상품이 어느 시점에 등록됐는지에 따라 진행 중인 결제 일정에 포함할지, 완납 이후의 새 결제로 분리할지를 결정했습니다.
- 같은 추가 금액도 현재 단계에 따라 중도금, 잔금, 별도 추가 결제로 처리되기 때문에 화면 표시와 결제 요청이 동일한 기준을 사용해야 했습니다.
- 사용자가 직접 추가한 상품과 운영자가 계약에 추가한 상품은 모두 미결제 대상으로 해석하되, 기존 납부 이력은 유지하고 새로 발생한 금액만 현재 단계에 반영했습니다.
주요 예외 처리
모든 예외를 같은 오류로 처리하지 않고 결제를 멈춰야 하는 이유와 다음 행동을 상황별로 구분했습니다.
계약금 또는 중도금 가상계좌가 입금 대기 중인 경우
- 처리
- 선행 결제의 미입금 상태와 기존 가상계좌를 확인해 새 결제 요청을 막았습니다.
- 결과
- 결제 버튼 대신 기존 계좌번호, 입금액, 만료기한을 확인할 수 있게 했습니다.
드레스샵 후보가 있지만 샵이 확정되지 않은 경우
- 처리
- 드레스 투어일보다 중도금 납부기한이 먼저인 경우를 제외하고 중도금과 잔금 결제를 제한했습니다.
- 결과
- 샵 확정이 필요하다는 안내와 확정 화면으로 이동하는 행동을 제공했습니다.
결제 진행 후 업체 또는 상품 구성이 변경된 경우
- 처리
- 현재 상품 구성만으로 과거 금액을 다시 만들지 않고 실제 중도금과 잔금 납부액을 우선해 남은 금액을 계산했습니다.
- 결과
- 기존 결제 금액은 유지하고 변경으로 새로 발생한 미결제 금액을 구분해 보여줬습니다.
회고
사용자 선택에 즉시 반응해야 해서 가격 계산을 프론트에서 담당했습니다. 하지만 정책이 늘어나면서 같은 규칙이 여러 화면에 누적되고 서버의 최종 검증 결과와 맞춰야 하는 부담이 커졌습니다.
지금 다시 구현한다면 기존 계약 상태와 프론트에서 선택된 옵션들을 가격 미리보기 API로 전달하고 서버가 예상 총액과 단계별 금액을 계산하도록 하겠습니다.
프론트는 요청 중 상태와 최신 응답 반영을 담당하고 주요 계약 조합은 서버 계산 결과를 기준으로 회귀 테스트해 규칙의 수정 지점을 한곳으로 모으겠습니다.