결제 게이트웨이 통합

빠른 설정

먼저 게이트웨이를 설정하세요. 그런 다음 청구서 보기와 결제 규칙을 선택하세요. 대부분의 호텔은 5분 안에 설정을 완료합니다.

이 가이드는 설정 → 결제에서 결제 및 청구서 규칙을 설정하는 데 도움이 됩니다. Stripe를 사용한다면 연결하기 전에 Live 또는 Test를 선택하세요. 게이트웨이 Stripe 자격 증명은 결제 카드에 저장됩니다. 터미널 수동 자격 증명은 터미널 설정 카드에 저장되며 테스트 키만 사용합니다. 호텔이 수동 Stripe 테스트 자격 증명을 사용한다면, 게이트웨이 카드와 터미널 카드에 각각 따로 저장됩니다. 각 카드에 맞는 Stripe 테스트 키를 사용하세요. 숙박 요금 정책은 PMS에서 제공하는 값과 일치합니다. Opera의 Booking.com (VCC) 같은 여행사 이름도 일치하는 면제를 유발할 수 있습니다. Opera 객실 패키지 면제의 경우 AVA는 먼저 객실 요금, 객실 서비스 요금 및 객실 GST를 면제합니다. 도착 전 Opera 예상 금액에서는 예상 객실 요금과 해당 요금 정보 세금이 함께 면제됩니다. 별도로 게시된 추가 항목과 해당 세금은 계속 지불해야 합니다. Mews에서는 일치하는 요금에 포함된 검증된 상품(예: 번들 조식)이 숙박 요금 면제를 따를 수 있습니다. 해당 면제 후 AVA는 숙박 요금 반올림 잔액인 경우에만 양수 THB 0.01 잔액을 숨깁니다. 실제 추가 항목과 분류되지 않은 요금은 실제 THB 0.01 추가 항목을 포함하여 계속 지불해야 합니다. 이 페이지에서 예전 OTA 소스 선택기는 더 이상 사용되지 않습니다.

찾는 위치

설정 → 결제

빠른 참고

설정 영역	제어 대상	주요 결과
청구서 보기	상세 또는 간소화된 투숙객 청구서 요약	항목별 행 또는 짧은 요약 표시
결제 게이트웨이 통합	Stripe 또는 Red Dot 설정	키오스크 흐름에서 투숙객 결제 가능
Stripe 환경	Stripe 게이트웨이와 터미널 연결의 Live/Test 모드	연결 후 잠김
수동 Stripe 테스트 자격 증명	게이트웨이 및 터미널 카드의 테스트 전용 Stripe 키	게이트웨이와 터미널 Stripe 설정을 분리 저장
터미널 결제 구성	Stripe 터미널 API 키, 공개 키, 웹훅 비밀	게이트웨이 Stripe와 별도로 저장
결제 수집 모드	보증금 및 전액 결제 토글	체크인 시 투숙객이 무엇을 지불하는지 제어
코멘트 기반 객실 결제 면제	예약 코멘트의 면제 키워드	PMS가 키워드 면제 지원을 노출할 때 잔액 차단을 건너뜀
AVA 청구 규칙	객실/세금/보증금/부대 요금의 숨김 및 면제 신호	숨겨진 행을 ✅로 표시하고 지불 가능 총액은 숫자로 유지
숙소 통화(설정 → 기본)	보증금 및 예약 결제 표시에 적용되는 확정 통화	설정과 운영 전반에서 결제 금액 일관성 유지
보증금 통화	이 페이지의 보증금 금액에 사용하는 통화	다른 결제 설정과 함께 저장
Opera 결제 매핑	정산, 캐셔, 결제 유형 매핑	Opera에 결제 게시가 올바르게 전달됨
체크아웃 반올림 조정	소액 잔액 허용 범위 및 체크아웃 조정	지원되는 PMS 제공업체가 소액 잔액으로 체크아웃 완료 가능
사전 승인 제어	Stripe 사전 승인에서 객실 요금을 지연 캡처	활성 PMS가 지연 캡처를 지원할 때 표시
Opera 전용 결제 제어	체크아웃 확인, 라우팅 및 수집 안 함 로직	Opera 전용 결제 동작 적용

라운딩 종속성

라운딩 조정은 체크인 정책에서 체크인 미결제 잔액 차단 또는 체크아웃 잔액 정산 중 하나가 켜져 있어야만 동작합니다. 둘 다 꺼져 있으면 AVA는 저장된 라운딩 값을 유지하지만 제어는 비활성 상태로 남습니다. AVA는 활성 PMS가 체크아웃 반올림 지원을 보고할 때만 이 제어 기능을 표시합니다. 기능 데이터가 없거나 잘못된 경우 제어 기능이 숨겨집니다.

기능 기반 제어

AVA는 활성 PMS의 기능에서 체크아웃 반올림 지원 여부를 읽습니다. 해당 기능에 공급업체 코드 필드가 선언된 경우에만 **거래 코드(반올림)**를 표시합니다. 지원되지 않거나 검증되지 않은 PMS 기능은 새로운 반올림 설정을 전송하지 않습니다.

시작 전에

• 결제 게이트웨이 계정을 준비하세요.
• 상세 또는 간소화 청구서 보기 중 사용할 방식을 결정하세요.
• 보증금, 전액 결제, 또는 둘 다 사용할지 정하세요.
• 설정 → 기본 → 호텔 기본 정보에서 보증금 정책과 숙소 통화 기준을 확인하세요.
• PMS가 숙박 결제 정책 기능을 노출하는지 확인하세요. AVA가 지원 여부를 확인할 수 없으면 제어 기능이 숨겨집니다.
• Auto Delay Capture가 필요하다면 PMS가 지연 사전 승인 캡처 지원을 노출하는지 확인하세요.
• Opera를 사용한다면 AVA 청구 규칙이 먼저 그곳에서 제공됩니다.
• PMS가 결제 매핑을 지원한다면 캐셔 ID와 결제 방법 코드 매핑을 준비하세요.

단계별 설정

1단계: 결제 게이트웨이 선택

1. 설정 → 결제로 이동합니다.
2. 결제 게이트웨이 통합에서 Stripe 또는 Red Dot Payment를 선택합니다.

Stripe 사용

1. 고급을 엽니다.
2. Live 또는 Test를 선택합니다.
3. Stripe 연결을 클릭합니다.
4. Stripe 온보딩을 완료합니다.
5. Streamliner로 돌아와 Stripe가 연결되었는지 확인합니다.

Stripe 모드

프로덕션에는 Live, 샌드박스 온보딩에는 Test를 사용하세요. Stripe가 연결된 뒤에는 연결을 끊기 전까지 환경이 읽기 전용이 됩니다.

터미널 Stripe 설정도 연결하기 전에 바꾸지 않으면 기본값이 Live입니다.

수동 Stripe 테스트 자격 증명

호텔에서 수동 Stripe 테스트 자격 증명 필드를 사용할 수 있을 때 이 기능을 사용하세요.

1. 편집하려는 Stripe 카드를 엽니다.
2. 공개 가능 키, 비밀 키 및 웹훅 비밀을 입력합니다.
3. 해당 카드에는 테스트 전용 키만 사용합니다.
4. 저장을 클릭합니다.
5. 나중에 필드가 마스킹되면 다시 입력하지 말고 Save를 한 번 더 클릭합니다.

Stripe 카드 분리

게이트웨이 Stripe 자격 증명은 결제 게이트웨이 카드에 저장됩니다. 터미널 Stripe 자격 증명은 터미널 설정 카드에 저장됩니다. 게이트웨이와 터미널 키를 분리하세요.

터미널 체크아웃

키오스크에 매핑된 Stripe 터미널이 하나면, AVA가 체크아웃 중 자동으로 엽니다. 여러 개가 있으면 결제 모달의 터미널 선택기에서 선택합니다. 터미널 모드가 꺼져 있으면 AVA는 게이트웨이 또는 QR 결제 흐름을 유지합니다. 키오스크가 직접 Stripe Terminal 자격 증명을 사용하면 Stripe Account ID가 비어 있어도 체크아웃을 시작할 수 있습니다. 직접 자격 증명과 Connect 계정이 모두 있으면 AVA는 Connect 계정 동작을 유지합니다. 터미널 수동 자격 증명은 게이트웨이 Stripe 자격 증명과 별개입니다. 테스트 터미널에만 사용하세요. 필드가 마스킹되어 있어도 값을 다시 입력하지 않고 저장할 수 있습니다.

Red Dot Payment 사용

1. 가맹점 ID를 입력합니다.
2. 비밀 키를 입력합니다.
3. 환경(TEST 또는 LIVE)을 선택합니다.
4. 결제 게이트웨이 설정 저장을 클릭합니다.

2단계: 청구서 보기 선택

이 카드로 투숙객에게 보이는 청구서 요약을 제어합니다. 항목별 행을 보려면 상세를 선택합니다. 객실 요금, 세금, 총액만 보려면 간소화를 선택합니다.

1. 설정 → 결제로 이동합니다.
2. 청구서 보기에서 상세 또는 간소화를 선택합니다.
3. 저장을 클릭합니다.

청구서 보기 위치

이 카드는 결제 페이지의 터미널 결제 구성 앞에 표시됩니다.

3단계: 결제 수집 옵션 선택

토글	기능
보증금 수집	체크인 중 보증금을 사전 승인
전액 결제 수집	체크인 중 투숙객이 미결제 잔액을 결제

1. 하나 또는 둘 다 켭니다.
2. 둘 다 꺼져 있으면 체크인에서 결제를 요청하지 않습니다.
3. 결제 게이트웨이 설정 저장을 클릭합니다.

4단계: 보증금 세부 설정(활성화된 경우)

1. 보증금 금액을 입력합니다.
2. 보증금 유형(1박당 또는 정액)을 선택합니다.
3. 보증금 통화가 보이면 호텔에서 보증금에 사용하는 통화를 선택합니다.
4. 결제 게이트웨이 설정 저장을 클릭합니다.

보증금 통화 출처

결제 설정은 설정 → 기본 → 호텔 기본 정보의 확정된 숙소 통화를 사용합니다. PMS가 통화를 제공하면 AVA는 그 값을 사용하고 로컬 편집은 잠급니다. 선택한 보증금 통화는 다른 결제 설정과 함께 저장됩니다.

숙박 요금 정책 구성

PMS가 숙박 결제 정책을 지원할 때 이 제어 기능을 사용합니다. 이 기능은 설정 → 결제의 결제 정책 제어 아래에 표시됩니다.

제어 기능	기능
숙박 요금 면제	숙박 요금, 관련 세금 또는 서비스 요금을 수집하지 않습니다. 해당 행은 계속 표시됩니다.
숙박 요금 숨기기 및 면제	숙박 요금, 관련 세금 또는 서비스 요금을 숨기고 수집하지 않습니다.

별도로 게시된 추가 항목과 해당 세금은 어느 정책에서든 계속 표시되고 지불할 수 있습니다. 두 정책이 일치하면 숨김 정책은 표시 여부만 변경합니다. 지불 금액은 동일하게 유지됩니다.

1. 설정 → 결제로 이동합니다.
2. 결제 정책 제어 → 숙박 요금 정책을 찾습니다.
3. PMS의 각 일치 값을 적절한 목록에 추가합니다.
4. 결제 정책 저장을 클릭합니다.
5. 구성한 값과 일치하는 예약을 테스트합니다.

Opera 소스 라벨

Opera가 여행사 라벨을 반환하면 AVA는 Booking.com (VCC) 같은 값을 읽을 수 있습니다. 그 라벨이 면제 정책 값과 일치할 수 있습니다.

공통 면제 동작

AVA가 키워드 면제 지원을 확인할 수 없으면 편집기는 계속 숨겨집니다. Cloudbeds, eZee, Ava, Furama, 알 수 없는 벤더, 지원되지 않는 PMS 버전은 이 필드를 표시하지 않습니다.

1. Payment Policy Controls를 엽니다.
2. PMS가 예약 코멘트에 쓰는 면제 키워드를 입력합니다.
3. Save를 클릭합니다.
4. 해당 키워드가 포함된 예약으로 테스트합니다.

AVA 청구 규칙

PMS가 객실, 세금, 보증금, 부대 요금에 대해 숨김 또는 면제 신호를 보낼 때 사용합니다.

• Mews와 Opera는 연결 기능이 허용할 때 이 규칙을 지원합니다.
• 숨겨진 객실 또는 세금 행은 상세 청구에서 ✅로 표시됩니다.
• 면제된 객실 또는 세금 행은 제공업체가 반환하면 계속 표시됩니다.
• Mews v2 면제 정책은 전체 청구서의 요금 행을 지울 수 있습니다.
• 번들 조식과 같은 검증된 Mews 요금 포함 상품은 객실 패키지 면제를 따를 수 있습니다.
• 검증된 포함 상품을 기준으로 가격이 책정된 서비스 요금은 해당 면제를 따를 수 있습니다.
• 면제 후 숙박 요금 반올림 잔액인 경우에만 양수 Mews 잔액 THB 0.01 이하를 숨깁니다.
• 분류되지 않은 양수 요금과 실제 추가 항목은 실제 THB 0.01 추가 항목을 포함하여 계속 지불해야 합니다.
• Opera 객실 패키지 면제의 경우 AVA는 객실 요금, 객실 서비스 요금, 객실 GST를 먼저 면제합니다.
• 도착 전 예상 Opera 객실 요금과 해당 요금 정보 세금은 함께 면제됩니다.
• 별도로 게시된 Opera 추가 항목과 해당 세금은 계속 지불할 수 있습니다.
• 면제된 보증금 또는 부대 요금 행은 지불 총액에서 제거됩니다.
• 평가된 지불 금액이 체크아웃 중 표시되고 수집되는 잔액을 결정합니다.
• 다른 이유로 청구서가 평가되지 않으면 AVA는 PMS 요약 또는 저장된 스냅샷을 사용할 수 있습니다.
• Mews의 판단 불가 면제는 검증되지 않은 금액을 사용하지 않으므로 직원이 전체 청구서를 검토해야 합니다.
• 객실 결제 수집이 활성화되면 AVA는 예약 조회 중 투숙객을 프런트 데스크로 안내할 수 있습니다.
• AVA가 상품 분류를 입증할 수 없으면 검증되지 않은 금액을 직원 검토를 위해 보류합니다.
• 명시적인 Opera 잔액 0은 표시되는 객실, 세금 또는 서비스 게시가 양수로 보여도 0으로 유지됩니다. 이는 라우팅되었거나 정산된 대응 항목이 표시되지 않을 때 적용됩니다. AVA는 금액과 통화가 정규화된 Opera 청구서와 일치할 때만 이 0을 신뢰합니다. 불일치는 미확인 상태로 유지됩니다.
• 간소화 청구에는 숨겨진 객실 및 세금 행, 추가 항목 구분선과 코드별로 그룹화된 추가 항목이 표시됩니다.
• PMS가 동기화를 완료하는 동안 예상 청구 행이 계속 표시될 수 있습니다.
• 예상치 못한 잔액은 결제를 수집하기 전에 PMS와 비교합니다.
• 어떤 정책도 일치하지 않으면 AVA는 수신한 청구서 응답을 사용합니다.

기능 기반 출시

PMS가 AVA 청구 규칙을 지원하지 않으면 AVA는 일반 결제 요약을 유지합니다.

1. PMS 청구 규칙을 사용하는 예약을 엽니다.
2. AVA에서 예약을 새로고칩니다.
3. 보이는 행과 지불 잔액을 비교합니다.
4. PMS 동기화가 끝난 뒤 다시 테스트합니다.

5단계: PMS 결제 매핑 구성(지원되는 경우)

1. Opera PMS Payment Mapping에서 다음을 설정합니다.
   • Settlement Code
   • Default Cashier ID
   • Default Comment Type / Location
   • Payment Type to Payment Method Code 행
2. Save Opera Payment Mapping을 클릭합니다.

매핑 행 동작

각 행은 하나의 결제 수단을 하나의 OPERA 결제 방법 코드에 연결합니다. AVA는 이 행들을 다른 결제 설정과 함께 저장합니다.

Opera 결제 코멘트 기본값

AVA는 Opera 결제 또는 보증금 코멘트를 만들 때 설정한 Default Comment Type / Location을 보냅니다. 이 값을 바꾼 뒤에는 매핑을 다시 저장하세요.

6단계: 체크아웃 반올림 조정 구성

PMS가 지원하면 AVA는 이 제어 기능을 결제 정책 제어 아래에 표시합니다.

PMS 제공업체	지원 여부	추가 설정
AVA	지원됨	공급업체 코드 필요 없음
Opera / OHIP	지원됨	**거래 코드(반올림)**에 공급업체 코드 저장
Cloudbeds, Mews, eZee 및 Furama	지원되지 않음	제어 기능이 숨겨짐

1. 설정 → 체크인 → 체크인 정책으로 이동합니다.

2. 체크인 미결제 잔액 차단 또는 체크아웃 잔액 정산을 켭니다.

3. 설정 → 결제로 이동합니다.

4. 결제 정책 제어를 찾습니다.

5. 반올림 조정 활성화를 켭니다.

6. 숙소 기본 통화로 반올림 기준값을 설정합니다.

7. Opera를 사용하면 **거래 코드(반올림)**에 공급업체 코드를 입력합니다.

8. 결제 정책 저장을 클릭합니다.

   ✓ 잔액이 기준값 이내이면 AVA가 체크아웃 중 조정을 적용합니다.

조정 작동 방식

체크인 중 AVA는 거래를 게시하지 않고 구성된 기준값 이내의 잔액을 허용합니다. 체크아웃 중 AVA는 체크아웃을 완료하기 전에 반올림 조정을 게시합니다. AVA는 공급업체 코드를 사용하지 않습니다. Opera는 구성된 공급업체 코드를 사용합니다.

7단계: 자동 지연 캡처 구성

PMS가 지연 캡처를 지원하면 자동 지연 캡처를 사용합니다. AVA는 Stripe 사전 승인이 만료되기 전에 객실 요금을 캡처하며, 보증금은 캡처하지 않습니다.

설정	기능
자동 지연 캡처 활성화	사전 승인 만료 전에 객실 요금을 자동으로 캡처
자동 지연 캡처 만료 일수	AVA가 만료 며칠 전에 객실 요금을 캡처할지 설정

1. 설정 → 결제로 이동합니다.

2. 결제 정책 제어 → 사전 승인 제어를 찾습니다.

3. 자동 지연 캡처 활성화를 켭니다.

4. 자동 지연 캡처 만료 일수를 입력합니다.

5. 결제 정책 저장을 클릭합니다.

   ✓ 사전 승인이 유효한 동안 AVA는 만료 전에 객실 요금을 캡처합니다.

기능 기반 표시

AVA는 활성 PMS가 지연 캡처 지원을 보고할 때만 이 제어 기능을 표시합니다. 현재 Opera는 지원을 보고합니다. 다른 PMS는 동일한 기능을 보고한 후에 표시합니다.

PMS 변경으로 설정이 지워질 수 있음

지연 캡처를 지원하지 않는 PMS로 전환하면 AVA는 자동 지연 캡처를 끄고 만료 일수 값도 지웁니다.

8단계: Opera 전용 결제 제어 구성(Opera만 해당)

1. 설정 → 결제로 이동합니다.

2. Opera 전용 결제 제어를 찾습니다.

3. 결제 동작을 설정합니다.

   • 체크아웃을 위한 현장 청구서 액세스 및 생년월일 확인
   • 면제 결제 라우팅 무시 동작

4. 부대 요금 / 보증금을 수집하지 않음에 일치하는 요금 코드, 시장 세그먼트, 보증 유형 또는 코멘트를 추가합니다.

5. 결제 정책 저장을 클릭합니다.

   ✓ 일치하는 부대 요금 또는 보증금 행은 지불 가능 잔액에서 제거됩니다.

Opera 결제 코멘트

AVA는 결제 또는 보증금을 게시하기 전에 Opera 예약 코멘트를 추가하려고 합니다. 코멘트 생성에 실패해도 AVA는 Streamliner에서 결제 또는 보증금을 계속 게시합니다. 숙박 요금 정책은 위에서 구성합니다.

라운딩 조정 종속성

Opera의 라운딩 설정이 결제 동작에 영향을 주게 하려면 이 설정을 사용합니다.

1. 설정 → 체크인 → 체크인 정책으로 이동합니다.

2. 체크인 미결제 잔액 차단 또는 체크아웃 잔액 정산을 켭니다.

3. 설정 → 결제로 돌아갑니다.

4. Opera Payment Policy Controls를 열고 Rounding adjustment를 설정합니다.

   ✓ 해당 체크인 정책 중 하나가 켜져 있을 때만 라운딩 설정이 적용됩니다.

저장된 값은 유지됨

나중에 두 체크인 잔액 정책을 모두 끄더라도 AVA는 저장된 라운딩 값을 유지합니다. 제어가 결제 동작에 영향을 주지 않을 뿐입니다.

저장 후 예상되는 내용

• ✅ 설정 후 연결된 게이트웨이 세부 정보가 보임
• ✅ Stripe 연결 상태 배지에 Live 또는 Test가 표시됨
• ✅ 청구서 보기가 다른 결제 설정과 함께 저장됨
• ✅ 보증금이 활성화되면 보증금 필드가 표시됨
• ✅ 저장을 클릭하면 보증금 통화가 유지됨
• ✅ Opera 매핑과 Opera 정책 섹션은 Opera PMS에서만 표시됨

마이그레이션 참고

결제 설정은 설정 → 기본에서 설정 → 결제로 이동했습니다. 기존 OTA 소스 선택기는 제거되었습니다.

문제 해결

게이트웨이 설정이 비활성화됨

보이는 현상: 결제 토글이나 저장 버튼이 비활성화됨

해결 방법:

1. 계정에 설정 쓰기 권한이 있는지 확인합니다.
2. Stripe를 선택했다면 먼저 Stripe를 연결합니다.
3. 페이지를 새로고침하고 다시 시도합니다.

청구서 보기가 바뀌지 않음

보이는 현상: 투숙객에게 예전 청구서 요약 레이아웃이 계속 보임

해결 방법:

1. 설정 → 결제로 돌아갑니다.
2. Detailed 또는 Simplified를 다시 선택합니다.
3. 청구서 보기 카드에서 Save를 클릭합니다.
4. 새 게스트 흐름을 시작하거나 예약 화면을 새로고칩니다.
5. 그래도 이상하면 호텔이 현재 CCI 설정 경로에 있는지 확인합니다.

Stripe 환경이 잠김

보이는 현상: Stripe 연결 후 Environment 드롭다운이 비활성화됨

해결 방법:

1. Stripe 연결을 끊습니다.
2. Advanced를 엽니다.
3. Live 또는 Test를 선택합니다.
4. Stripe를 다시 연결합니다.

Stripe 터미널 자격 증명이 거부됨

보이는 현상: 게이트웨이 또는 터미널 Stripe 자격 증명이 저장되지 않거나, 저장 후 AVA가 지움

해결 방법:

1. 올바른 Stripe 카드를 편집 중인지 확인합니다.
2. 게이트웨이와 터미널 자격 증명은 따로 저장됩니다.
3. 수동 Stripe 설정에는 테스트 전용 값을 사용합니다.
4. 비밀 키가 sk_test_로 시작하는지 확인합니다.
5. 공개 키가 pk_test_로 시작하는지 확인합니다.
6. 다시 저장합니다.
7. 필드가 마스킹되어 있으면 값을 다시 입력하지 말고 한 번 더 저장합니다.

Stripe 테스트 자격 증명이 보이지 않음

보이는 현상: 게이트웨이 또는 터미널 카드에 수동 Stripe 필드가 없음

해결 방법:

1. 설정 → 결제를 새로고칩니다.
2. 호텔이 수동 Stripe 테스트 자격 증명 출시 대상인지 확인합니다.
3. 그래도 보이지 않으면 지원팀에 문의합니다.

Opera 섹션이 보이지 않음

보이는 현상: Opera 매핑과 정책 카드가 없음

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. PMS 제공업체가 Opera인지 확인합니다.
3. 설정 → 결제로 돌아갑니다.
4. 페이지를 한 번 새로고칩니다.
5. Step 3: Configure Opera PMS Payment Mapping이 보이는지 확인합니다.

자동 지연 캡처가 누락됨

표시되는 내용: 사전 승인 제어에 자동 지연 캡처가 표시되지 않습니다.

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. 올바른 PMS가 활성화되어 있는지 확인합니다.
3. PMS 연결을 변경한 후 설정 → 결제를 새로 고칩니다.
4. PMS가 지연 캡처 지원을 보고하는지 관리자 또는 Vouch 지원팀에 문의합니다.

PMS가 지원을 보고하지 않으면 제어 기능은 숨겨진 상태로 유지됩니다.

자동 지연 캡처 설정이 거부됨

표시되는 내용: 결제 설정을 저장할 때 AVA가 지연 캡처를 사용할 수 없다고 표시합니다.

해결 방법:

1. 활성 PMS가 지연 캡처를 지원하는지 확인합니다.
2. PMS 제공업체를 변경했다면 자동 지연 캡처를 끕니다.
3. 결제 설정을 저장합니다.
4. PMS 기능을 사용할 수 있게 된 후 다시 시도합니다.

AVA는 지원되지 않거나 검증되지 않은 PMS의 지연 캡처 설정을 저장하지 않습니다.

Opera 결제 매핑이 저장되지 않음

보이는 현상: 저장 후 캐셔 또는 결제 수단 행이 사라짐

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. Opera가 여전히 활성 PMS인지 확인합니다.
3. 설정 → 결제로 돌아갑니다.
4. Default Cashier ID와 각 매핑 행을 다시 입력합니다.
5. Save Opera Payment Mapping을 다시 클릭합니다.

Opera 결제 통화가 맞지 않음

보이는 현상: Opera가 내부 오류를 보이거나, 결제/보증금 게시 후 보이지 않음

해결 방법:

1. 설정 → 기본 → 호텔 기본 정보의 Property Currency를 확인합니다.
2. Opera 예약의 통화가 같은지 확인합니다.
3. 결제나 보증금을 다시 시도합니다.
4. Opera가 계속 내부 오류를 반환하면 지원팀에 문의합니다.

Opera 예약 코멘트가 없음

보이는 현상: 결제는 성공했지만 Opera에 새 예약 코멘트가 보이지 않음

해결 방법:

1. Streamliner에서 결제 또는 보증금이 성공했는지 확인합니다.
2. Opera 예약에 일치하는 결제 기록이 있는지 확인합니다.
3. Opera PMS Payment Mapping에서 Default Comment Type / Location이 설정되어 있는지 확인합니다.
4. 코멘트만 다시 만들려고 재시도하지 마세요.
5. 결제는 게시되는데 코멘트가 계속 안 보이면 지원팀에 문의합니다.

Opera 코멘트 유형 또는 위치가 이상함

보이는 현상: Opera가 결제 코멘트를 만들긴 하지만 유형이나 위치가 예상과 다름

해결 방법:

1. 설정 → 결제를 엽니다.
2. Opera PMS Payment Mapping을 확인합니다.
3. Default Comment Type / Location을 검증합니다.
4. 매핑을 다시 저장합니다.
5. 다른 Opera 결제나 보증금으로 테스트합니다.

객실 결제가 예기치 않게 면제됨

표시되는 내용: 결제를 기대했는데 예약이 객실 결제를 건너뜁니다.

해결 방법: PMS 청구서와 AVA 청구 규칙을 비교하고, 일치하는 정책 값과 객실 요금 분류를 확인합니다.

결제 면제 키워드 필드가 없음

표시되는 내용: 숙박 요금 정책 제어가 표시되지 않습니다.

해결 방법: 활성 PMS가 숙박 결제 정책 기능을 보고하는지 확인합니다. 지원되지 않거나 확인되지 않은 경우 제어 기능은 숨겨집니다.

청구 행이 PMS와 맞지 않음

표시되는 내용: 객실, 세금, 보증금 또는 부대 요금 행이 PMS와 다릅니다.

해결 방법: PMS 동기화가 완료될 때까지 기다린 뒤 AVA에서 예약을 새로 고치고, 지불 가능 금액을 PMS 청구서와 비교합니다.

Mews 포함 상품 검토 필요

보이는 현상: 결제를 기대했는데 예약이 객실 결제를 건너뜀

해결 방법:

1. PMS에서 예약을 엽니다.
2. 예약 코멘트, 소스 이름, Opera 여행사 라벨을 확인합니다.
3. 예약이 면제되면 안 된다면 키워드를 제거하거나 변경합니다.
4. AVA를 새로고치고 새 예약으로 다시 테스트합니다.

결제 전에 투숙객이 프런트 데스크로 안내됨

보이는 현상: 면제 키워드 필드가 보이지 않거나, Payment Policy Controls에 지원되지 않는 PMS 메시지가 보임

해결 방법:

1. PMS 제공업체가 키워드 면제를 지원하는지 확인합니다.
2. 설정 → 결제를 새로고칩니다.
3. 그래도 필드가 안 보이면 아직 해당 PMS에 대한 지원 데이터가 없는 것입니다.
4. 기존 면제 키워드는 그대로 두세요. 편집기가 숨겨져도 AVA는 계속 저장합니다.

투숙객에게 결제를 요청하지 않음

보이는 현상: 객실, 세금, 보증금, 부대 요금 행이 AVA에서 다르게 보임

해결 방법:

1. 예약이 AVA 청구 규칙을 지원하는 PMS에서 왔는지 확인합니다.
2. Opera를 사용하면 다음 예약 동기화를 기다립니다.
3. 설정 → 결제를 새로고치거나 예약을 다시 엽니다.
4. PMS 청구서를 확인해 해당 행이 숨겨졌는지 면제되었는지 확인합니다.

보증금 통화가 이상하거나 수정할 수 없음

보이는 현상: 체크인 중 결제를 건너뜀

해결 방법:

1. 게이트웨이가 연결되어 있는지 확인합니다.
2. Collect Security Deposits 또는 Collect Full Payment가 활성화되어 있는지 확인합니다.
3. 예약에 미결제 잔액이 있는지 확인합니다.
4. 저장하고 샘플 예약으로 다시 테스트합니다.

체크아웃 반올림을 사용할 수 없음

보이는 현상: 보증금 통화가 예상과 다르거나 변경 사항이 유지되지 않음

해결 방법:

1. 설정 → 기본 → 호텔 기본 정보를 엽니다.
2. Property Currency가 PMS 관리인지 편집 가능한지 확인합니다.
3. PMS 관리라면 PMS에서 통화를 수정하고 동기화를 기다립니다.
4. 설정 → 결제를 새로고쳐 통화를 확인합니다.

라운딩 조정이 계속 비활성 상태임

보이는 현상: Rounding adjustment가 회색으로 남아 있거나 저장된 값이 결제 동작을 바꾸지 않음

해결 방법:

1. 설정 → 체크인 → 체크인 정책을 엽니다.
2. 체크인 미결제 잔액 차단 또는 체크아웃 잔액 정산을 켭니다.
3. 설정을 저장합니다.
4. 설정 → 결제로 돌아가 라운딩 값이 여전히 저장되어 있는지 확인합니다.

아직도 막히나요?

• 체크인 정책
• PMS 연결
• Opera PMS 통합

관련 가이드

다음 경우 success@vouch-technologies.com으로 문의하세요.

• ❌ 설정을 다시 저장해도 결제가 계속 실패함
• ❌ 청구서 보기 변경이 투숙객에게 보이지 않음
• ❌ Opera 매핑 값이 유지되지 않음
• ❌ Stripe 또는 Red Dot 연결이 반복해서 끊김

함께 보내면 좋은 정보:

• 설정 → 결제 스크린샷
• PMS 제공업체 이름
• 예시 예약 ID와 타임스탬프