Skip to main content

​
Balance Management

경로: billing.seahorse.dnotitia.ai → 관리자 → Balance Management 테넌트의 잔액을 운영자가 직접 조정합니다. 보너스 크레딧 지급, 환불 처리, 분쟁 대응 등에 사용됩니다.

​
주요 기능

  • 테넌트 잔액 조회 — UUID·이메일로 검색
  • 보너스 충전 — 환불 불가 보너스 잔액으로 지급 (이벤트·프로모션·고객 보상)
  • 수동 차감 — 오과금 정정·시스템 오류 보정
  • 환불 처리 — 충전 잔액(refundable) 환불 → PG 연동
  • 트랜잭션 이력 — 운영자 조작 내역 감사

​
잔액 종류

종류환불 가능우선순위용도
충전 잔액 (Paid Balance)✓후순위사용자가 결제 수단으로 직접 충전
보너스 잔액 (Bonus Balance)✗우선 차감가입 무료 크레딧·이벤트·운영 보상
사용 시 보너스 → 충전 잔액 순으로 차감됩니다. 보너스를 지급하면 사용자의 충전 잔액 소진을 늦출 수 있어 고객 보상에 적합합니다.

​
운영 주의

  • 잔액 조정은 즉시 반영 되며 되돌리려면 반대 트랜잭션을 별도로 실행해야 합니다. 금액·테넌트 UUID 입력을 두 번 확인하세요.
  • 환불은 PG 정책에 따라 시간이 걸릴 수 있습니다 (영업일 기준 3~7 일). 사용자에게 사전 안내.
  • 운영자 조작은 모두 감사 로그에 기록 됩니다. 사유(예: 티켓 번호) 를 메모 필드에 명시하세요. → Events
  • 분쟁 대응 시 Tenant Management 에서 사용량 이력을 먼저 확인하고 사용량 내역 의 메서드별 호출을 검토.

​
관련 문서