숙소예약 시스템

에어비앤비 스타일의 숙소 예약 솔루션

실시간 예약 관리 자동 정산 시스템 SMS/이메일 알림 토스페이먼츠 연동

핵심 기능

강력하고 유연한 숙소 예약 관리를 위한 모든 기능

숙소/객실 관리

다양한 형태의 숙소와 객실을 효율적으로 관리합니다.

숙소 등록 및 정보 관리
객실 타입별 관리
다중 이미지 업로드
유연한 가격 설정

예약 시스템

안정적인 예약 프로세스로 원활한 운영을 지원합니다.

실시간 예약 처리
골든타임 결제 시스템
자동 만료 처리
중복 예약 방지

결제 연동

안전하고 편리한 결제 시스템을 제공합니다.

토스페이먼츠 연동
결제 상태 실시간 추적
환불 처리 자동화
결제 내역 관리

정산 관리

투명하고 정확한 정산 시스템을 운영합니다.

주간 자동 정산
수수료 자동 계산
호스트별 정산 내역
정산 리포트 생성

호스트 시스템

호스트를 위한 전용 관리 기능을 제공합니다.

호스트 신청 및 승인
숙소 관리 대시보드
예약 현황 모니터링
수익 통계 확인

게스트 관리

게스트 편의를 위한 다양한 기능을 지원합니다.

비회원 예약 지원
휴대폰 본인 인증
예약 조회 시스템
마이페이지 제공

리스크 관리

안전한 서비스 운영을 위한 보호 기능입니다.

블랙리스트 관리
소프트락 시스템
악성 이용자 차단
이상 행동 탐지

알림 시스템

실시간 알림으로 중요 정보를 전달합니다.

SMS 알림 (솔라피)
이메일 알림
관리자 알림
예약 상태 알림

역할별 대시보드

각 사용자 역할에 최적화된 전용 대시보드 제공

🧳

게스트

숙소 검색 및 예약
온라인 결제
예약 내역 조회
마이페이지

🏡

호스트

숙소/객실 관리
재고 및 가격 관리
예약 현황 확인
정산 내역 조회

📋

매니저

전체 예약 관리
예약 승인/취소
정산 처리
호스트 지원

⚙️

관리자

시스템 설정
호스트 관리
SMS/이메일 설정
통계 및 리포트

🏡 호스트 체험하기

테스트 계정으로 호스트 기능을 직접 체험해보세요

📝 호스트 가입 신청 📊 호스트 대시보드

Test Account

ID host@test.com

PW 1234qwer

📋 매니저 체험하기

테스트 계정으로 매니저 기능을 직접 체험해보세요

📊

매니저 대시보드 전체 예약/정산 통합 관리

Test Account

ID book_manager@test.com

PW 1234qwer

최고관리자 메뉴 보기

관리자 페이지에서 설정할 수 있는 다양한 옵션들

🗺️ 지도 설정

숙소 위치 표시를 위한 지도 API 키를 설정합니다. 숙소 등록 시 주소 검색과 지도 표시에 사용됩니다.

지도 서비스 선택

이 모듈에서 사용할 지도 서비스를 선택합니다.

Kakao JavaScript 키

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Kakao Developers에서 발급받은 JavaScript 키

Naver Client ID

xxxxxxxxxx

Naver Cloud Platform에서 발급받은 Client ID

Google Maps API 키

AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Google Cloud Console에서 발급받은 API 키

💰 환불 정책

예약 취소 시 적용되는 환불 정책을 설정합니다. 성수기/비수기, 주중/주말에 따라 차등 환불율을 적용합니다.

📢 계약 후 24시간 이내 무료 취소 정책 시행

2024년 12월 27일부터 시행되는 공정위 개정안에 따라, 소비자가 예약한 후 24시간 이내에 취소할 경우 위약금 없이 취소가 가능하도록 기준이 강화되었습니다.
(단, 사용예정일 0시 이전까지로 제한)
* 이 규칙은 아래의 설정보다 우선적으로 적용됩니다.

성수기 설정

성수기 기간

7월 15일 ~ 8월 31일 (기간 추가 가능)

매년 반복되는 성수기 기간을 설정합니다. 여러 구간을 설정할 수 있습니다.

승인 후 무료 취소 설정

무료 취소 시간

10 분

호스트 승인(또는 자동 승인) 시점부터 설정된 시간 동안은 위약금 없이 100% 환불됩니다.

환불 비율 설정

예약 취소 시점별 환불 비율(%)을 설정합니다. 0%는 환불 없음, 100%는 전액 환불을 의미합니다.

취소 시점	비수기 주중	성수기 / 주말(금,토)
사용예정일 10일 전까지	100%	100%
사용예정일 7일 전까지	100%	80%
사용예정일 5일 전까지	100%	60%
사용예정일 3일 전까지	90%	40%
사용예정일 1일 전까지	80%	10%
사용 당일 또는 No-show	70%	0%

🚫 블랙리스트 설정

제재 등급별 차단 기간 및 고객센터 연락처를 설정합니다.

등급별 차단 기간

등급 (Level)	설명	차단 기간
Level 1	단순 예약-취소 반복 (노쇼 우려)	7 일
Level 2	파트너 폭언, 고의적 업무 방해	30 일
Level 3	중대한 노쇼, 허위 리뷰 반복	365 일
Level 4	결제 도용, 범죄 연루, 매크로	영구 차단

고객센터 연락처

1588-0000

차단 안내 문구에 표시될 고객센터 번호

📋 문자 전송 내역

발송된 SMS/알림톡 이력을 조회합니다.

Period 2026-01-01 ~ 2026-01-31

No	발송일시	수신번호	유형	채널	상태	내용
1	2026-01-17 14:30	010-****-1234	예약확인	알림톡	성공	[OO숙소] 예약이 확정되었습니다...
2	2026-01-17 14:25	010-****-5678	인증번호	SMS	성공	[OO숙소] 인증번호 [123456]...

📬 이메일 전송 내역

발송된 이메일 이력을 조회합니다.

No	발송일시	수신자	유형	상태	제목	조회
1	2026-01-17 14:30	guest@example.com	예약확정	성공	[OO숙소] 예약이 확정되었습니다
2	2026-01-17 14:25	host@example.com	새예약	성공	[OO숙소] 새로운 예약이 접수되었습니다

🔗 주소정보

이 모듈에서 사용되는 라우트 주소와 연결되는 페이지입니다. 실제 라우트 정보는 관리자 페이지에서 확인할 수 있습니다.

📦 매니저 페이지 (관리자/매니저용)

매니저 권한으로 숙소, 객실, 재고를 종합 관리하는 페이지들입니다.

페이지명	라우트 패턴	설명
대시보드	`/****/******`	매니저 대시보드
숙소 목록	`/****/******/properties`	전체 숙소 관리
예약 목록	`/****/******/bookings`	전체 예약 관리
정산 목록	`/****/******/settlements`	전체 정산 관리

🏡 호스트용 페이지

호스트 전용 관리 페이지들입니다. 호스트 가입 승인 후 접근 가능합니다.

페이지명	라우트 패턴	설명
대시보드	`/****/***`	호스트 대시보드
숙소 목록	`/****/***/properties`	내 숙소 목록
숙소 상세	`/****/***/properties/{id}`	숙소 상세 보기/수정
예약 목록	`/****/***/bookings`	내 숙소 예약 목록
정산 목록	`/****/***/settlements`	내 정산 내역

👥 일반 회원/비회원용 페이지

숙소 검색, 예약, 마이페이지 등 일반 사용자가 접근하는 페이지들입니다.

페이지명	라우트 패턴	설명
숙소 검색	`/******/search`	숙소 검색 페이지
숙소 상세	`/******/properties/{id}`	숙소 상세 정보
예약 조회	`/******/lookup`	비회원 예약 조회
내 예약	`/******/my/bookings`	회원 예약 내역

🔒

보안 안내

관리자 페이지 URL은 보안을 위해 마스킹 처리되어 있습니다. 실제 경로는 모듈 라우팅 설정을 참조하세요.

📚 기능정보

예약 모듈의 주요 자동화 기능 및 시스템 설정에 대한 설명입니다.

⏰ 승인 대기 타임아웃

게스트가 결제 완료 후 호스트의 승인을 기다리는 최대 시간입니다. 마감 시간이 지나면 예약이 자동 취소되고 전액 환불됩니다.

체크인까지 남은 시간	호스트 응답 마감	설명
7일 이상	24시간	여유로운 예약의 경우 호스트에게 충분한 확인 시간 부여
2일 ~ 7일	12시간	중간 기간 예약, 빠른 응답 권장
48시간 미만	2시간	긴급 예약, 즉각적인 응답 필요

안전장치

체크인 2시간 전 마감: 마감 시간은 체크인 시간 2시간 전을 절대 초과하지 않습니다.
최소 10분 보장: 이미 체크인 2시간 전이 지난 경우에도 최소 10분의 응답 시간이 주어집니다.
체크인 날짜 경과: 체크인 날짜가 이미 지난 예약은 즉시 자동 취소됩니다.

🌟 Golden Time (무료 취소 기간)

호스트가 예약을 승인한 후 게스트에게 주어지는 무료 취소 가능 기간입니다.

현재 설정: 승인 후 10분 호스트 승인 시점부터 10분 내 취소 시 전액 환불

적용 조건

호스트가 예약을 confirmed 상태로 승인한 경우에만 적용
golden_time_deadline 필드에 마감 시간 저장
마감 시간 전 취소 시 환불 정책과 관계없이 전액 환불

❄️ Cool-Off 시스템

호스트가 승인 대기(awaiting_approval) 상태의 예약을 단기간 내 여러 번 거절할 경우 해당 객실을 자동으로 일시 정지하는 시스템입니다.

적용 대상: awaiting_approval (승인 대기) 상태의 예약 거절 시에만 적용
※ confirmed (확정) 상태의 예약 취소는 Cool-Off 대신 호스트 취소 패널티가 적용됩니다.

조건	조치	설명
24시간 내 2회 이상 거절	24시간 일시 정지	해당 객실의 예약 접수가 24시간 동안 중지됨

해제 방법

자동 해제: 24시간 후 cron job에 의해 자동 해제
수동 해제: 매니저가 검토 후 수동으로 해제 가능
면책 신청: 호스트가 정당한 사유로 면책 신청 가능

블랙리스트 예외

블랙리스트 회원의 예약을 거절할 경우 거절 이력에서 제외됩니다.
이로 인한 판매 중단 처리도 면제됩니다.

⚠️ 호스트 취소 패널티

호스트가 승인한 예약(confirmed)을 취소할 경우 적용되는 패널티 시스템입니다. 게스트에게는 전액 환불되며, 호스트에게는 차등 패널티가 부과됩니다.

패널티 요율 (체크인까지 남은 기간 기준)

체크인까지 남은 기간	패널티 요율	예시 (100,000원 예약)
7일 이상	5%	5,000원 패널티
7일 미만 ~ 24시간 전	10%	10,000원 패널티
24시간 이내 (당일 포함)	20%	20,000원 패널티

취소 사유 및 면책 가능 여부

사유 코드	패널티 적용	면책 심사	설명
`host_personal`	적용	불가	호스트 개인 사정 (단순 변심)
`facility_issue`	적용	가능	숙소 설비 문제 (증빙 제출 필수)
`force_majeure`	적용	가능	천재지변/불가항력 (증빙 제출 필수)
`guest_violation`	미적용	-	게스트 규정 위반 (노쇼, 허위 예약 등)

면책 심사 프로세스

1.증빙 제출: 호스트가 설비 문제/불가항력 사유로 취소 시 증빙 파일 첨부
2.심사 대기: 취소 내역이 pending 상태로 저장
3.매니저 심사: 매니저가 증빙 확인 후 승인/반려 결정
4.결과 반영: 승인 시 패널티 면제, 반려 시 패널티 확정

정산 연동

패널티 금액은 호스트 정산 시 자동 차감됩니다.
기존 정산서가 있으면 즉시 차감, 없으면 다음 정산에 포함
면책 승인된 건은 정산에서 제외

🔄 Cron Job (자동화 작업)

시스템 자동화를 위해 주기적으로 실행되어야 하는 작업입니다.

실행 작업 목록

cancelExpiredBookings: 만료된 예약 취소 처리
processPendingBookings: 결제 대기 예약 상태 확인
cancelExpiredAwaitingApprovals: 승인 대기 타임아웃 처리
unpauseCoolOffRooms: Cool-Off 만료 객실 해제

소개

숙소예약 시스템

핵심 기능

숙소/객실 관리

예약 시스템

결제 연동

정산 관리

호스트 시스템

게스트 관리

리스크 관리

알림 시스템

역할별 대시보드

게스트

호스트

매니저

관리자

🏡 호스트 체험하기

Test Account

📋 매니저 체험하기

Test Account

최고관리자 메뉴 보기

🗺️ 지도 설정

🔐 권한 설정

📅 예약 설정

레이트 체크인 / 최소 숙박 보장

보안 설정

💳 결제 설정

토스페이먼츠 API 설정

💰 환불 정책

성수기 설정

승인 후 무료 취소 설정

환불 비율 설정

🔒 소프트락 설정

기본 설정

어뷰징 차단 설정

🚫 블랙리스트 설정

등급별 차단 기간

📜 약관 설정

예약조건 및 이용약관

취소 및 환불 정책 안내

📱 문자 설정

API 설정

예약 알림 설정

카카오 알림톡 설정 (선택)

상황별 알림톡 템플릿 ID (선택)

📋 문자 전송 내역

📧 이메일 설정

기본 설정

🧳 게스트 알림

🏡 호스트 알림

📋 매니저 알림

📬 이메일 전송 내역

🔗 주소정보

📦 매니저 페이지 (관리자/매니저용)

🏡 호스트용 페이지

👥 일반 회원/비회원용 페이지

📚 기능정보

⏰ 승인 대기 타임아웃

안전장치

🌟 Golden Time (무료 취소 기간)

적용 조건

❄️ Cool-Off 시스템

해제 방법

블랙리스트 예외

⚠️ 호스트 취소 패널티

패널티 요율 (체크인까지 남은 기간 기준)

취소 사유 및 면책 가능 여부

면책 심사 프로세스

정산 연동

🔄 Cron Job (자동화 작업)

실행 작업 목록

로그인