병원 고객, 운영 관리자, 결제 시스템 관점의 크레딧 자동 충전 흐름 설계도입니다.
크레딧 잔액 확인부터 결제 수단 갱신까지 병원 고객의 실제 운영 흐름입니다.
현재 크레딧과 예상 소진 시점 확인
충전 기준 금액과 결제 수단 등록
통역 사용 건별 차감 이력 확인
카드 만료 또는 한도 초과 안내 확인
서비스 유예 기간 안에 카드 재등록
병원 담당자가 현재 잔액, 자동 충전 기준, 예상 소진 시간을 한눈에 확인하는 화면입니다.
잔액이 기준 이하로 내려가면 자동 충전 후보가 되고, 담당자에게 사전 알림을 보냅니다.
자동 충전에 사용할 카드를 등록하고 만료 예정 상태를 확인합니다.
빌링키 상태를 내부 결제 수단 상태와 분리해 카드 만료와 해지를 추적합니다.
크레딧이 왜 늘고 줄었는지 담당자가 확인하는 원장 화면입니다.
모든 증감은 원장 이벤트로 남겨 결제와 실제 사용량의 근거를 맞춥니다.
실패 결제와 미수금을 운영자가 빠르게 판단하고 조치하는 흐름입니다.
자동 충전 실패 고객 확인
카드 만료, 한도 초과, 네트워크 오류 구분
정책에 따른 자동 또는 수동 재시도
서비스 유지 또는 제한 상태 변경
결제 성공 후 제한 해제와 원장 반영
미수금, 실패 횟수, 유예 만료 시간을 기준으로 우선순위를 보여줍니다.
운영자가 수동 판단하지 않도록 상태와 다음 조치를 함께 표시합니다.
실패 원인, 재시도 이력, 알림 발송 여부를 한 화면에서 확인합니다.
실패 원인에 따라 자동 재시도와 담당자 알림 정책이 다르게 적용됩니다.
운영자가 크레딧을 수동 보정할 때 사유와 승인자를 남기는 화면입니다.
수동 조정도 원장 이벤트로 기록해 나중에 정산 근거가 사라지지 않게 합니다.
잔액 감지부터 웹훅 검증과 원장 반영까지 시스템 내부 흐름입니다.
임계값 이하 병원 자동 탐지
중복 방지를 위한 시도 이력 선생성
빌링키 기반 자동 결제 요청
결제 성공 여부와 중복 수신 확인
성공 건만 크레딧 증가 이벤트 기록
자동 충전 한 건이 어떤 상태를 거쳤는지 추적하는 시스템 로그입니다.
모든 결제는 대기, 요청, 성공, 실패, 재시도, 미수 중 하나의 상태를 가집니다.
토스 웹훅 수신 결과와 내부 반영 여부를 검증합니다.
동일 결제 키는 한 번만 원장에 반영되며 지연 수신은 결제 조회로 보정합니다.
실패한 자동 충전 건의 다음 재시도 시점과 제한 전환 시점을 관리합니다.
정해진 정책에 따라 재시도하고 실패가 누적되면 미수금 또는 제한 상태로 전환합니다.