환불내역¶

이 페이지에서 찾을 수 있는 것

환불 / 환불내역 / 결제취소 / 카드취소 / 현금환불 / 선납권 환불 / 환불 이력

결제가 취소되거나 환불된 내역을 모아서 조회하는 페이지입니다. 환불 사유·금액·환불일자별 추적 + 회계 자료로 활용.

주소: /sales/refund

화면 구성¶

영역	위치	내용
상단 필터	화면 위	기간(환불일자) / 환불사유 / 결제수단 / 환자명·차트번호
메인 표	가운데	환자명·차트번호·원결제일·환불일·환불금액·결제수단·사유·처리자
합계 박스	우측 상단	환불 총액 + 건수
액션	표 우측	원 결제 조회 / 차트 진입

환불 유형 종류¶

유형	의미
결제취소	전액 환불 (가장 흔함, 카드취소 포함)
부분 환불	일부 금액만 환불
선납권 환불	선납권 잔여 + 시술 정가 차감
포인트 환불	포인트 잔여 환불 (전액 삭제)

결제수단별 환불 흐름¶

카드: PG(PAY-STORY) 자동 취소 → 원카드 환불 (5~7일 소요)
현금: 현금 직접 환불 (메모에 기록)
계좌이체: 환불 계좌로 송금 (수동)
선납권: 잔여 차감 후 환불 (포인트→선납금 순)

정책 (WI#66, 2026-05-13)¶

결제 일자 가드 (createPayment)¶

미래 일자 → ❌ 차단 (PAYMENT_DATE_FUTURE)
30일 이전 → ❌ 차단 (PAYMENT_DATE_TOO_OLD)
과거 결산 재계산 방지

환불 자동 정리 (WI#66 Phase D)¶

전액 환불 + 잔여 결제 0이면: - progress_notes.total_amount 자동 0 - bigeum_amount / bonbu_amount / paid_amount 자동 0 - emr_memo에 [자동정리 ... 전액 환불 반영] 기록 - → 환불 후 미수 잘못 표시 방지

자주 쓰는 동작¶

시나리오 1 — 카드 결제 환불 처리¶

수납 팝업 또는 환불내역 → 원 결제 선택
결제취소 버튼 클릭
환불사유 입력 (필수)
PG 자동 취소 → 원카드 환불 (5~7일)
자동 차트 매출 0 처리 (Phase D)

시나리오 2 — 부분 환불 (분납 환자)¶

원결제 선택 → 부분 환불 옵션
환불 금액 입력 (전액보다 작게)
사유 + 메모 기록
progress_notes paid_amount 차감

시나리오 3 — 선납권 환불¶

환자상세 → 선납권 탭
환불 버튼 → 환불 모달
정책: 포인트는 전액 삭제, 사용한 시술은 정가 차감
최종 환불액 = 선납금 잔액 - 시술 정가

시나리오 4 — 환불 이력 회계 정리¶

기간 = 정산 대상 월
환불 총액 확인
엑셀 다운로드 → 회계팀 전달
부가가치세 / 카드매출 정정 신고

권한별 차이¶

Level	사용 가능
1~2 (관리자)	✅ 전체 환불 등록·취소
3 (의료진/CS팀장)	환불 등록 (취소는 관리자)
4 (실장)	본인 처리 환불만 보기

자주 발생하는 문제 / FAQ¶

Q1. 카드 환불을 했는데 환자 카드에 안 들어왔다고 해요. A. PG 환불은 평균 5~7일 소요. 1주 이상 경과 시 PAY-STORY 또는 카드사 문의. 시스템상 status='refunded'면 정상 처리된 것.

Q2. 환불일자를 어제로 변경하고 싶어요. A. WI#24 cancelDate 옵션 — 환불 모달에서 취소일자 수동 지정 가능 (원결제일 이후 ~ 오늘 사이). 회계 정정 용도.

Q3. 환불했는데 미수내역에 미수 200만으로 보여요. A. 2026-05-13 핫픽스 후 자동 정리됨. 옛 데이터는 차트의 total_amount를 0으로 정정 필요. 운영팀 문의.

Q4. 선납권을 환불했는데 차감액이 너무 큽니다. A. 선납권 환불 정책: 포인트 전액 삭제 + 사용 시술 정가 차감. 정가 차감액이 크면 환불 잔액이 적어짐 (예: 100만 선납 + 50만 시술 사용 → 환불 = 100만 - 시술정가).

Q5. 환불 후에도 매출에 그대로 잡혀요. A. 매출 인식 시점이 원결제 일자면 그대로 (회계 원칙). 환불은 환불일자 별도 표시. 순매출 = 매출 - 환불.