결제 게이트웨이 통합
먼저 결제 게이트웨이를 설정하세요. 그런 다음 보증금과 Opera 결제 정책 규칙을 설정하세요. 대부분의 호텔은 5분 안에 끝냅니다.
이 가이드는 새 Payment 설정 페이지에서 결제 수금 규칙을 설정하는 방법을 안내합니다. Stripe를 사용하는 경우 연결하기 전에 Live 또는 Test를 먼저 선택하세요.
위치
Settings → Payment빠른 참고
| 설정 영역 | 제어 항목 | 주요 결과 |
|---|---|---|
| Payment Gateway Integration | Stripe 또는 Red Dot 설정 | 키오스크 흐름에서 게스트가 결제할 수 있습니다 |
| Stripe Environment | Stripe 게이트웨이와 단말 연결의 Live 또는 Test 모드 | 연결 후 잠김 |
| Payment Collection Mode | 보증금 및 전액 결제 토글 | 체크인 시 게스트가 무엇을 결제할지 제어합니다 |
| Property Currency (in Settings → Essentials) | 보증금과 예약 결제 표시를 위해 해석된 통화 | 설정과 운영 전반에서 결제 금액을 일관되게 유지합니다 |
| Deposit Currency | 이 페이지의 보증금 금액에 사용하는 통화 | 다른 결제 설정과 함께 저장됨 |
| Opera Payment Mapping (Step 3 card) | 정산, 캐셔, 결제 유형 매핑 | Opera에 결제 전기가 올바르게 반영됩니다 |
| Opera Payment Policy Controls | 반올림, 사전 승인, 면제/숨김 로직 | Opera 전용 결제 동작이 적용됩니다 |
시작 전 준비
- 결제 게이트웨이 계정을 준비합니다.
- 보증금, 전액 결제, 또는 둘 다 사용할지 결정합니다.
- 보증금 정책과 Settings → Essentials → Hotel Basic Details의 숙소 통화 원본을 확인합니다.
- Opera를 사용하는 경우 캐셔 ID와 결제 수단 코드 매핑을 준비합니다.
단계별 설정
1단계: 결제 게이트웨이 선택
- Settings → Payment로 이동합니다.
- Payment Gateway Integration에서 Stripe 또는 Red Dot Payment를 선택합니다.
Stripe의 경우
- Advanced를 엽니다.
- Live 또는 Test를 선택합니다.
- Connect Stripe를 클릭합니다.
- Stripe 온보딩을 완료합니다.
- Streamliner로 돌아와 Stripe가 연결되었는지 확인합니다.
운영 환경에서는 Live를, 샌드박스 온보딩에는 Test를 사용합니다. Stripe가 연결되면 연결을 끊을 때까지 환경은 읽기 전용이 됩니다.
단말 Stripe 설정은 연결하기 전에 변경하지 않으면 기본값이 Live입니다.
키오스크에 매핑된 Stripe 단말이 하나만 있으면 체크아웃 중 AVA가 자동으로 엽니다. 둘 이상 매핑된 경우에는 결제 모달의 단말 선택기에서 고릅니다. 단말 모드가 꺼져 있으면 AVA는 게이트웨이 또는 QR 결제 흐름을 유지합니다.
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박당 또는 고정 금액)을 선택합니다.
- Deposit Currency가 보이면 호텔에서 보증금에 사용하는 통화를 선택합니다.
- Save Payment Gateway Settings를 클릭합니다.
결제 설정은 Settings → Essentials → Hotel Basic Details의 확인된 Property Currency를 사용합니다. PMS가 통화를 제공하면 AVA는 해당 값을 사용하고 로컬 편집을 잠급니다. 선택한 Deposit Currency는 다른 결제 설정과 함께 저장됩니다.
4단계: Opera 결제 매핑 설정 (Opera 전용)
- Step 3: Configure Opera PMS Payment Mapping에서 다음을 설정합니다.
- Settlement Code
- Default Cashier ID
- Default Comment Type / Location
- Payment Type to Payment Method Code 행
- Save Opera Payment Mapping을 클릭합니다.
각 행은 하나의 결제 수단을 하나의 OPERA 결제 수단 코드와 연결합니다. AVA는 이 행들을 다른 결제 설정과 함께 저장합니다.
5단계: Opera 결제 정책 제어 설정 (Opera 전용)
- Opera Payment Policy Controls에서 결제 동작을 설정합니다.
- 인보이스 표시 및 체크아웃 검증
- 반올림 조정 및 거래 코드
- 자동 지연 캡처 옵션
- 면제 / 숨김 / 미수집 규칙 목록
- Save Payment Policies를 클릭합니다.
Opera 결제 또는 보증금 전기가 성공하면 AVA가 Opera에 예약 메모를 추가합니다. 이 작업은 자동으로 수행되며 Streamliner의 결제 결과는 바꾸지 않습니다.
저장 후 기대 동작
- ✅ 설정 후 연결된 게이트웨이 세부 정보가 표시됩니다.
- ✅ Stripe는 연결 상태 배지에 Live 또는 Test로 표시됩니다.
- ✅ 보증금을 활성화하면 보증금 필드가 표시됩니다.
- ✅ Save를 클릭하면 보증금 통화가 계속 저장됩니다.
- ✅ Opera 매핑과 Opera 정책 섹션은 Opera PMS에서만 표시됩니다.
- ✅ 활성 PMS 제공사가 Opera일 때 Step 3: Configure Opera PMS Payment Mapping 카드가 나타납니다.
- ✅ 결제 설정은 같은 페이지에서 서로 독립적으로 저장됩니다.
결제 설정 위치가 Settings → Essentials에서 Settings → Payment로 이동했습니다.
문제 해결
게이트웨이 설정이 비활성화됨
보이는 내용: 결제 토글 또는 저장 버튼이 비활성화됩니다.
해결:
- 계정에 설정 쓰기 권한이 있는지 확인합니다.
- Stripe를 선택했다면 먼저 Stripe를 연결합니다.
- 페이지를 새로고침하고 다시 시도합니다.
Stripe 환경이 잠김
보이는 내용: Stripe가 연결된 뒤 Environment 드롭다운이 비활성화됩니다.
해결:
- Stripe 연결을 끊습니다.
- Advanced를 엽니다.
- Live 또는 Test를 선택합니다.
- Stripe를 다시 연결합니다.
Opera 섹션이 표시되지 않음
보이는 내용: Opera 매핑과 정책 카드가 보이지 않습니다.
해결:
- Settings → Essentials → PMS Integration을 엽니다.
- 활성 PMS 제공사가 Opera인지 확인합니다.
- Settings → Payment로 돌아갑니다.
- 페이지를 한 번 새로고침합니다.
- Step 3: Configure Opera PMS Payment Mapping이 표시되는지 확인합니다.
Opera 결제 매핑이 저장되지 않음
보이는 내용: Save를 클릭한 뒤 캐셔 또는 결제 수단 행이 사라집니다.
해결:
- Settings → Essentials → PMS Integration을 엽니다.
- Opera가 여전히 활성 PMS인지 확인합니다.
- Settings → Payment로 돌아갑니다.
- Default Cashier ID와 각 매핑 행을 다시 입력합니다.
- Save Opera Payment Mapping을 다시 클릭합니다.
Opera 예약 메모가 없음
보이는 내용: 결제는 성공했지만 Opera에 새 예약 메모가 보이지 않습니다.
해결:
- Streamliner에서 결제 또는 보증금이 성공적으로 끝났는지 확인합니다.
- Opera 예약에 일치하는 결제 기록이 있는지 확인합니다.
- 호텔 정책상 허용될 때만 결제를 다시 시도합니다.
- 결제는 전기되었는데 메모가 여전히 나타나지 않으면 지원팀에 문의합니다.
투숙객에게 결제가 요청되지 않음
보이는 내용: 체크인 중 게스트가 결제 단계를 건너뜁니다.
해결:
- 게이트웨이가 연결되어 있는지 확인합니다.
- Collect Security Deposits 또는 Collect Full Payment가 활성화되어 있는지 확인합니다.
- 예약에 미결제 잔액이 있는지 확인합니다.
- 저장 후 샘플 예약으로 다시 테스트합니다.
보증금 통화가 잘못 보이거나 편집할 수 없음
보이는 내용: 보증금 통화가 예상한 설정과 다르거나, 필드 변경 사항이 유지되지 않습니다.
해결:
- Settings → Essentials → Hotel Basic Details를 엽니다.
- Property Currency가 PMS에서 관리되는지 또는 편집 가능한지 확인합니다.
- PMS에서 관리되는 경우 PMS에서 통화를 업데이트한 뒤 동기화를 기다립니다.
- Settings → Payment를 새로고침하고 통화를 확인합니다.
관련 설정
계속 해결되지 않나요?
다음에 해당하면 success@vouch-technologies.com으로 문의하세요.
- ❌ 설정을 다시 저장해도 결제가 계속 실패함
- ❌ Opera 매핑 값이 유지되지 않음
- ❌ Stripe 또는 Red Dot 연결이 반복적으로 끊김
함께 전달하면 좋은 정보:
- Settings → Payment 화면 스크린샷
- PMS 제공사 이름
- 예시 예약 ID와 발생 시각