결제 게이트웨이 통합
빠른 설정
먼저 Settings → Essentials → Hotel Basic Details에서 숙소 통화를 확정하세요. 그다음 결제 게이트웨이와 수집 규칙을 구성하고 샘플 예약으로 결제 흐름을 테스트하세요.
이 가이드는 Payment 설정 페이지에서 결제 게이트웨이와 결제 수집 규칙을 구성하는 방법을 안내합니다.
위치
Settings → Payment빠른 참고
| 설정 영역 | 제어 항목 | 주요 결과 |
|---|---|---|
| Payment Gateway Integration | Stripe 또는 Red Dot 설정 | 키오스크 플로우에서 고객 결제 가능 |
| Payment Collection Mode | 보증금 및 전액 결제 토글 | 체크인 시 고객이 결제할 항목 제어 |
| Opera Payment Mapping | 정산, cashier, 결제 유형 매핑 | Opera에 결제 전기가 정확히 반영됨 |
| Opera Payment Policy Controls | 반올림, 사전 승인, 면제/숨김 로직 | Opera 전용 결제 동작을 강제 적용 |
시작 전 준비
- 결제 게이트웨이 계정을 준비합니다.
- 보증금, 전액 결제, 또는 둘 다 수집할지 운영 정책을 확정합니다.
- 보증금 정책을 확정합니다.
- Opera를 사용하는 경우 cashiering 및 결제 매핑 값을 준비합니다.
단계별 설정
1단계: 결제 게이트웨이 선택
- Settings → Payment로 이동합니다.
- Payment Gateway Integration에서 Stripe 또는 Red Dot Payment를 선택합니다.
Stripe 설정
- Connect Stripe를 클릭합니다.
- Stripe 온보딩을 완료합니다.
- Streamliner로 돌아와 Stripe 연결 상태를 확인합니다.
Red Dot Payment 설정
- Merchant ID를 입력합니다.
- Secret Key를 입력합니다.
- Environment (
TEST또는LIVE)를 선택합니다. - Save Payment Gateway Settings를 클릭합니다.
2단계: 결제 수집 옵션 선택
| Toggle | 동작 |
|---|---|
| Collect Security Deposits | 체크인 중 보증금을 사전 승인 |
| Collect Full Payment | 체크인 중 미결제 잔액 전액 결제 |
- 토글을 하나 이상 켭니다.
- 둘 다 꺼져 있으면 체크인 시 결제를 요청하지 않습니다.
- Save Payment Gateway Settings를 클릭합니다.
3단계: 보증금 상세 설정 (활성화된 경우)
- Deposit Amount를 입력합니다.
- Deposit Type(1박당 또는 고정 금액)을 선택합니다.
- Save Payment Gateway Settings를 클릭합니다.
보증금 통화 기준
보증금 금액은 Settings → Essentials → Hotel Basic Details의 Property currency를 사용합니다.
4단계: Opera 결제 매핑 설정 (Opera 전용)
- Step 3: Configure Opera PMS Payment Mapping에서 다음 항목을 설정합니다.
- 정산 코드 (Settlement Code)
- 기본 Cashier ID
- 기본 코멘트 유형 / 위치
- Payment Type to Payment Method Code 행
- Save Opera Payment Mapping을 클릭합니다.
5단계: Opera 결제 정책 제어 설정 (Opera 전용)
- Opera Payment Policy Controls에서 결제 동작을 설정합니다.
- 인보이스 표시 및 체크아웃 검증
- 반올림 조정 및 거래 코드
- 자동 지연 캡처 옵션
- 면제 / 숨김 / 미수집 규칙 목록
- Save Payment Policies를 클릭합니다.
저장 후 기대 동작
- ✅ 설정 후 연결된 게이트웨이 정보가 표시됩니다.
- ✅ 보증금을 활성화하면 보증금 필드가 표시됩니다.
- ✅ Step 3: Configure Opera PMS Payment Mapping은 PMS 제공사가 Opera일 때만 표시됩니다.
- ✅ Opera Payment Policy Controls는 PMS 제공사가 Opera일 때만 표시됩니다.
- ✅ 동일 페이지에서 결제 설정 항목이 독립적으로 저장됩니다.
- ✅ Settings → Check-In → Check-In Policy를 저장해도 기존 Opera 매핑 값은 지워지지 않습니다.
마이그레이션 안내
결제 설정 위치가 Settings → Essentials에서 Settings → Payment로 이동했습니다.
문제 해결
게이트웨이 설정이 비활성화됨
증상: 결제 토글 또는 저장 버튼이 비활성화됩니다.
해결:
- 계정에 설정 쓰기 권한이 있는지 확인합니다.
- Stripe를 선택했다면 먼저 Stripe를 연결합니다.
- 페이지를 새로고침하고 다시 시도합니다.
Opera Step 3 섹션이 표시되지 않음
증상: "Step 3: Configure Opera PMS Payment Mapping"이 보이지 않습니다.
해결:
- Settings → Essentials → PMS Integration을 엽니다.
- 활성 PMS 제공사가 Opera인지 확인합니다.
- PMS 설정에서 Save를 클릭합니다.
- Settings → Payment로 돌아와 한 번 새로고침합니다.
체크인 중 고객에게 결제가 요청되지 않음
증상: 고객이 체크인 중 결제 단계를 건너뜁니다.
해결:
- 게이트웨이가 연결되어 있는지 확인합니다.
- Collect Security Deposits 또는 Collect Full Payment가 활성화되어 있는지 확인합니다.
- 해당 예약에 미결제 잔액이 있는지 확인합니다.
- 저장 후 샘플 예약으로 다시 테스트합니다.
보증금 금액이 잘못된 통화로 표시됨
증상: 보증금 라벨에 사용하지 않는 통화가 표시됩니다.
해결:
- Settings → Essentials → Hotel Basic Details로 이동합니다.
- Property currency를 업데이트합니다.
- Save를 클릭합니다.
- Settings → Payment로 돌아와 새로고침합니다.
관련 설정
계속 해결되지 않나요?
다음에 해당하면 success@vouch-technologies.com으로 문의하세요.
- ❌ 설정을 다시 저장해도 결제가 계속 실패함
- ❌ Opera 매핑 값이 유지되지 않음
- ❌ Stripe 또는 Red Dot 연결이 반복적으로 끊김
함께 전달하면 좋은 정보:
- Settings → Payment 화면 스크린샷
- PMS 제공사 이름
- 예시 예약 ID와 발생 시각