의류 쇼핑몰 운영 개선

마주한 문제

일부 금액만 환불했는데 주문 전체가 종료되고 매출에서도 전액이 빠졌습니다. 반대로 배송비를 공제한 전체 반품은 PG에서 부분취소로 보여도 업무상 주문은 끝나야 했습니다.

확인한 과정

화면을 열 때 계산한 종결 값을 환불액 변경 후에도 서버가 신뢰하고 있었습니다. 같은 주문 금액을 읽는 대시보드·주문 목록·고객 구매액·등급 계산도 환불을 반영하는지 이어서 확인했습니다.

선택한 방법

클라이언트의 종결 값을 없애고 서버가 결제 잔액·취소액·공제액으로 다시 판단하도록 바꿨습니다. 누적 환불액을 기록하고 관련 집계는 원 결제액에서 환불액을 빼도록 맞췄습니다.

어떻게 확인했는가

정정 전 미리보기, 당시 PG와 주문 DB의 거래 대조, 종결 규칙의 경우별 검사를 사용했습니다. 새 검사가 이전 로직에서는 실패하는지도 확인한 기록을 남겨 수정 효과를 구분했습니다.

단계별 처리와 경계

1. 서버 판정

   결제 잔액·취소액·공제액으로 주문 종결을 계산

2. 외부 취소

   PG 요청 결과 확인; 내부 DB와 비원자적

3. 내부 기록

   환불 누적액과 조건에 맞는 주문 상태를 저장

4. 관련 조회

   대시보드·목록·구매액이 환불 반영 금액을 사용

마주한 문제

송장 발급이 실패하거나 발급 후 DB에 남지 않았고, 저장한 출력 링크를 다시 열면 사용할 수 없는 문제가 이어졌습니다.

확인한 과정

실제 배송 계약 유형과 요청 값이 다르고, 응답의 중첩 구조와 항목별 결과를 빠뜨린 부분을 찾았습니다. 출력 링크는 영구 주소가 아니라 한 번 사용하도록 발급되는 값이었습니다.

선택한 방법

요청의 계약 유형과 개별 항목 응답 처리를 교정했습니다. 출력할 때 링크를 발급받도록 시점을 바꾸고, 배송 웹훅의 주문 매칭과 최초 운송장 저장 시 알림을 연결했습니다.

어떻게 확인했는가

당시 인계 기록에서 발급·저장·출력 경로의 수정과 배포 확인을 대조했습니다. 최상위 접수 성공, 항목별 발급 결과, 내부 저장을 별도의 확인 지점으로 나눴습니다.