결제 게이트웨이 통합

빠른 설정

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

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

찾는 위치

설정 → 결제

빠른 참고

설정 영역	제어 대상	주요 결과
청구서 보기	상세 또는 간소화된 투숙객 청구서 요약	항목별 행 또는 더 짧은 요약 표시
결제 게이트웨이 통합	Stripe 또는 Red Dot 설정	투숙객이 키오스크 흐름에서 결제 가능
Stripe 환경	Stripe 게이트웨이 및 터미널 연결의 Live 또는 Test 모드	연결 후 잠김
수동 Stripe 테스트 자격 증명	게이트웨이 및 터미널 카드의 테스트 전용 Stripe 키	게이트웨이와 터미널 Stripe 설정을 별도로 저장
터미널 결제 구성	Stripe 터미널 API 키, 공개 가능 키 및 웹훅 비밀	게이트웨이 Stripe와 별도로 터미널 자격 증명 저장
결제 수집 모드	보증금 및 객실 결제 선택	체크인 및 도착 전 과정에서 투숙객이 지불하는 항목 제어
ACI 결제 스위치	Assisted Check-In 직원이 결제를 요청할 수 있는지 여부	ACI 중에만 결제를 허용하거나 건너뜀
도착 전 온라인 결제	객실 및 보증금 토글, 이메일 시점 및 사전 승인 시나리오	도착 전에 가능한 온라인 결제 제어
숙박 요금 정책	숙박 요금을 면제하거나 숨기는 일치 값	PMS가 이 기능을 지원할 때 숙박 행과 지불 가능 금액 제어
AVA 청구 규칙	객실, 세금, 보증금 및 부대 요금 행의 숨김 및 면제 신호	숨겨진 행은 ✅로 표시하고 지불 가능 총액은 숫자로 유지하며 지불 가능한 추가 항목 보존
숙소 통화(설정 → 기본)	보증금 및 예약 결제 표시에 사용되는 확정 통화	설정과 운영 전반에서 결제 금액 일관성 유지
보증금 통화	이 페이지의 보증금 금액에 사용하는 통화	다른 결제 설정과 함께 저장
PMS 결제 매핑	PMS가 이 기능을 지원할 때 숙소별 결제 방법 매핑	PMS가 캡처된 결제를 의도한 범주로 기록
체크아웃 반올림 조정	소액 잔액 허용 범위 및 체크아웃 조정	지원되는 PMS 제공업체가 소액 잔액으로 체크아웃 완료 가능
사전 승인 제어	Stripe 사전 승인에서 객실 요금 캡처 지연	활성 PMS가 지연 캡처를 지원할 때 표시
Opera 전용 결제 제어	체크아웃 확인, 라우팅 및 수집 안 함 로직	Opera 전용 결제 동작 적용
No Post 제어	여정 및 보증금 정책에 따른 OPERA 게시 제한 제어	아래에 설명된 우선순위 규칙 적용

반올림 종속성

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

기능 기반 제어

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

PMS 터미널 사용 가능 여부

AVA는 활성 PMS 기능이 지원하는 경우에만 PMS 터미널 옵션을 표시합니다. 레거시 ows 제공업체에서는 AVA가 OPI 옵션을 제공하지 않습니다. 기존에 지원되는 PMS 터미널 설정은 계속 작동합니다.

v4 여정에서 OPERA No Post 이해하기

빠른 설정

v4 여정에서 AVA는 먼저 결제 정책을 확인한 다음 일치하는 No Post 토글을 확인합니다. 검토에는 약 2분이 걸립니다.

AVA는 아래에서 처음 일치하는 규칙을 사용하여 No Post를 적용합니다.

우선순위	적용되는 경우	결과
1	인증된 Assisted Check-In	2개 기기 ACI가 지원하는 경우 직원의 선택으로 결정됩니다. 그렇지 않으면 저장된 기본값으로 결정됩니다.
2	결제가 켜져 있고 수집하지 않음 또는 보증금 0인 키오스크 또는 대상 도착 전 여정	토글과 관계없이 No Post
3	결제가 켜져 있고 보증금이 필요한 키오스크	결제 후 No Post 설정에 따라 결정되며, 켜져 있으면 모든 키오스크 투숙객에게 No Post 적용
4	결제가 꺼진 키오스크	결제 후 No Post 설정에 따라 결정
5	보증금이 필요하거나 결제가 없는 도착 전 여정	구성된 결제 정책 따름

Assisted Check-In의 경우 AVA는 보증금 규칙보다 먼저 인증된 직원 기기의 결정을 확인합니다. 위조된 ACI 헤더로는 투숙객 정책을 우회할 수 없습니다. 이 선택은 해당 작업 중 PMS가 체크인하는 모든 예약에 적용됩니다. 여기에는 주 예약과 새로 체크인된 동반 투숙객이 포함됩니다. 이미 객실에 투숙 중인 예약에는 이 선택이 다시 제한을 적용하지 않습니다. ACI 복구는 ACI 설정을 따르고, 키오스크 복구는 키오스크 규칙을 따릅니다. 기존 v2 동작은 변경되지 않습니다.

결제 후 No Post 설정이 꺼져 있으면 필요한 보증금을 수집하지 않은 경우에만 키오스크 투숙객에게 No Post가 적용됩니다. 결제가 꺼져 있으면 결제 후 No Post 설정만 키오스크 결과를 결정합니다.

No Post 설정 선택

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

2. Opera 전용 결제 제어를 엽니다.

3. 대상 키오스크 투숙객 모두에게 No Post를 적용하려면 결제 후 No Post 설정을 켜 둡니다.

4. Assisted Check-In에서 기본적으로 No Post 선택을 사용하여 직원 선택을 미리 선택합니다.

5. 우선 적용될 수 있는 보증금 수집 및 수집하지 않음을 검토합니다.

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

   ✓ AVA는 다음에 해당하는 여정에서 저장된 설정을 사용합니다.

설정이 숨겨지는 경우

결제가 켜져 있고 수집하지 않음이 선택되어 있으면 AVA는 결제 후 No Post 설정을 숨깁니다. 이 경우 최우선 규칙이 이미 No Post를 강제합니다. AVA는 ACI 정책을 위해 Assisted Check-In에서 기본적으로 No Post 선택을 계속 사용할 수 있게 합니다.

2개 기기 ACI에서 직원이 결정하도록 하기

OPERA가 지원을 보고하면, 검증된 2개 기기 직원 키오스크에는 체크인 진행 위에 PMS에서 No Post 설정이 표시됩니다. 저장된 설정에 따라 이 확인란이 미리 선택됩니다. 직원은 체크인 전에 선택하거나 선택을 해제할 수 있습니다.

직원의 선택은 해당 ACI 작업에서 최종 결정입니다. 이 선택은 해당 작업 중 OPERA가 체크인하는 모든 예약에 적용됩니다. 원자적 다중 객실 체크인에서는 모든 객실 카드가 하나의 선택을 공유합니다. 보증금 설정은 이 ACI 선택을 덮어쓰지 않습니다.

이 확인란은 1개 기기 직원 키오스크나 투숙객 태블릿에는 표시되지 않습니다. 이러한 흐름에서는 저장된 설정을 사용합니다. 이전 직원 빌드도 계속 저장된 설정을 사용합니다.

키오스크 동반 투숙객

셀프서비스 키오스크 체크인은 해당 작업으로 새로 투숙 처리된 예약에 No Post를 적용합니다. 나중에 도착하는 동반 투숙객에게는 동반 투숙객의 새 예약에만 No Post가 적용됩니다. 나중에 투숙객이 합류해도 AVA는 객실 예약에 다시 제한을 적용하지 않습니다.

No Post는 후속 작업입니다

No Post 업데이트가 실패해도 OPERA 체크인은 성공할 수 있습니다. OPERA에서 예약을 확인하고 필요한 경우 제한을 수동으로 적용하세요. PMS가 No Post 지원을 선언하지 않으면 AVA도 요청을 건너뜁니다.

No Post를 사용할 수 없음

보이는 현상: No Post 상자가 없거나 저장된 기본값과 다른 결과가 나타납니다.

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. Opera가 활성 PMS인지 확인합니다.
3. 설정 → 결제를 새로 고칩니다.
4. 결제가 켜져 있고 수집하지 않음이 선택되어 있는지 확인합니다.
5. ACI의 경우 검증된 2개 기기 직원 키오스크를 사용하고 있는지 확인합니다.
6. 여정 유형과 일치하는 No Post 설정을 검토합니다.
7. Opera가 활성 상태인데 우선순위 동작이 올바르지 않으면 지원팀에 문의합니다.

AVA는 최우선 규칙이 항상 적용되는 경우 결제 후 No Post 설정을 숨깁니다. PMS 기능을 사용할 수 없거나 검증되지 않은 경우에도 Opera 제어 기능을 숨깁니다.

시작 전에

• 결제 게이트웨이 계정을 준비하세요.
• 상세 또는 간소화 청구서 보기 중 사용할 방식을 결정하세요.
• 체크인 중 보증금, 객실 결제 또는 둘 다 사용할지 결정하세요.
• 설정 → 기본 → 호텔 기본 정보에서 보증금 정책과 숙소 통화 기준을 확인하세요.
• 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 테스트 자격 증명 필드를 사용할 수 있을 때 이 기능을 사용하세요. 수동 Stripe 게이트웨이 저장에는 Test 모드와 세 자격 증명 필드가 모두 필요합니다. 공개 가능 키, 비밀 키, 웹훅 비밀을 함께 제공해야 합니다.

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

Stripe 카드 분리

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

테스트 자격 증명을 모두 입력해야 함

AVA는 수동 게이트웨이 저장 시 자격 증명이 완전하지 않으면 거부합니다. 저장이 거부되면 기존 자격 증명을 유지합니다. 마스킹된 필드는 저장할 때 마스킹된 값을 그대로 두세요.

터미널 체크아웃

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

Red Dot Payment 사용

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

2단계: 청구서 보기 선택

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

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

청구서 보기 위치

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

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

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

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

Assisted Check-In 결제 요청

Assisted Check-In에서는 직원이 객실별로 보증금, 객실 결제 또는 둘 다 요청할 수 있습니다. 객실에 결제 금액이 있으면 두 항목이 기본으로 선택됩니다. 직원은 결제를 요청하기 전에 어느 항목이든 선택 해제할 수 있습니다. 결제 금액이 없는 객실은 결제 단계 없이 계속 진행됩니다. Assisted Check-In 직원의 결제 수집 허용 스위치도 켜져 있어야 합니다. 이 스위치는 기본적으로 켜져 있으며 Self Check-In 또는 도착 전에는 영향을 주지 않습니다.

1개 기기 ACI에서는 직원이 체크인을 선택한 후 결제 요청이 표시됩니다. 기기는 먼저 직원 화면으로 돌아간 다음 투숙객이 결제를 완료합니다. 2개 기기 ACI에서는 직원이 결제 단계를 통해 투숙객 태블릿으로 결제를 보냅니다. 직원이 결제 항목을 보내지 않으면 투숙객 태블릿에서 결제를 요구하지 않습니다.

온라인 게이트웨이와 카드 리더를 모두 사용할 수 있으면 투숙객은 온라인 결제 또는 카드 리더로 결제를 선택합니다. 온라인 옵션에는 QR 코드가 표시됩니다. 카드 리더 옵션은 직원이 선택한 터미널을 사용합니다.

ACI 결제 선택은 객실별로 적용됩니다

결제를 시작하기 전에 각 객실에서 요청한 항목을 검토하세요. AVA는 직원이 해당 객실에서 선택 해제한 항목을 요구하지 않습니다.

Assisted Check-In 결제 요청 끄기

호텔에서 AVA 외부에서 ACI 결제를 수집할 때 이 설정을 사용하세요.

1. 설정 → 체크인 → 체크인 정책 → 키오스크 및 결제로 이동합니다.

2. Assisted Check-In 직원의 결제 수집 허용을 끕니다.

3. 저장을 선택합니다.

   ✓ ACI에서 더 이상 객실에 결제가 필요하다고 처리하지 않습니다. ✓ 1개 기기 ACI는 체크인으로 바로 계속 진행합니다. ✓ 2개 기기 ACI에서는 PAYMENT 단계를 제공하지 않습니다.

이 설정은 기본적으로 켜져 있습니다. Assisted Check-In에만 적용됩니다. Self Check-In 및 도착 전 결제 규칙은 변경되지 않습니다.

변경 사항이 적용되는 시점

키오스크는 다음 환영 페이지, 새 여정 또는 새로 고침 시 변경 사항을 불러옵니다. 열려 있는 태블릿 결제는 완료할 수 있으며, 직원이 건너뛸 수도 있습니다.

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

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

금액을 입력하기 전에 사전 승인 보류를 선택합니다. 이 옵션을 켜면 금액은 0보다 커야 합니다. 보증금 수집을 건너뛰려면 대신 수집하지 않음을 선택합니다.

저장된 보증금 모드가 없는 호텔의 기본값

호텔에서 이 설정을 한 번도 저장하지 않았다면 AVA는 수집하지 않음을 표시합니다. 숙소에 보증금이 필요하면 다른 모드를 선택하고 저장하세요.

0 금액으로는 보증금을 활성화할 수 없음

사전 승인 보류가 선택된 상태에서 보증금 금액이 비어 있거나 0이면 AVA가 거부합니다. 인라인 메시지에 오류가 설명되고 대신 "수집하지 않음"으로 전환 옵션이 제공됩니다.

게이트웨이 연결 필요

결제 게이트웨이가 연결될 때까지 AVA는 사전 승인 보류와 보증금 금액을 비활성화합니다. 잘못된 보증금 구성을 지울 수 있도록 수집하지 않음은 계속 사용할 수 있습니다.

보증금 통화 출처

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

결제 값 검사

AVA는 저장하기 전에 결제 값을 검사합니다. 필드를 편집할 수 있을 때는 아래 형식을 사용하세요.

설정	허용되는 값
보증금 통화	USD 또는 THB와 같은 대문자 3글자
반올림 임계값	0 이상인 숫자
거래 코드(반올림)	0 이상인 정수
Auto Delay Capture 만료 일수	0 이상인 정수

숙박 요금 정책 구성

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

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

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

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

기능 기반 표시

AVA는 활성 PMS가 필요한 기능을 제공할 때만 이 제어 기능을 표시합니다. 제어 기능을 일시적으로 사용할 수 없어도 기존 값은 저장된 상태로 유지됩니다.

Opera 소스 라벨

Opera가 여행사 라벨을 반환하면 AVA는 Booking.com (VCC)와 같은 값을 일치시킬 수 있습니다.

AVA 청구 규칙

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

• 연결 기능이 허용하면 Mews와 Opera가 이 규칙을 지원합니다.
• 상세 청구서에서는 숨겨진 객실 또는 세금 행이 ✅로 표시됩니다.
• 제공업체가 반환한 면제 객실 또는 세금 행은 계속 표시됩니다.
• Mews v2 면제 정책은 전체 청구서의 요금 행을 지울 수 있습니다.
• 번들 조식과 같은 검증된 Mews 요금 포함 상품은 객실 패키지 면제를 따를 수 있습니다.
• 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 동기화가 완료된 후 다시 테스트합니다.

도착 전 온라인 결제 구성

이 카드를 사용하면 대상 투숙객이 도착 전에 온라인으로 결제할 수 있습니다. 설정 → 결제 → 도착 전 온라인 결제에서 찾을 수 있습니다. 카드는 청구서 보기와 결제 수집 설정 뒤에 표시됩니다. 장기 투숙 도착 전 규칙은 설정 → 체크인 → 체크인 정책에서 구성합니다.

설정	제어 대상	요구 사항
도착 전 객실 결제 활성화	도착 전에 현재 객실 잔액 수집	객실 수집은 사전 승인 보류 또는 직접 판매 청구여야 함
도착 전 보증금 결제 활성화	도착 전에 구성된 보증금 사전 승인 요청	보증금 수집은 사전 승인 보류여야 함
사전 승인 유효 기간(일)	은행이 사전 승인을 유효하게 유지하는 기간	1~365일 입력

1. 설정 → 결제 → 도착 전 온라인 결제를 엽니다.

2. 객실 결제 스위치, 보증금 결제 스위치 또는 둘 다 켭니다.

3. 보증금을 수집할 때는 **사전 승인 유효 기간(일)**을 입력합니다.

4. 첫 번째 예약 이메일과 발송 시간을 검토합니다.

5. 사전 승인 시나리오 표를 검토합니다.

6. 저장을 클릭합니다.

   ✓ AVA는 객실 및 보증금 선택을 별도로 저장합니다. ✓ 투숙객은 도착 전 과정에서 현재 객실 및 보증금 금액을 확인합니다.

객실 결제는 신중하게 선택하세요

PMS가 OTA 결제 예약을 식별하거나 적절한 요금제를 제공할 때 객실 결제를 활성화하세요. 이렇게 하면 OTA가 이미 수집한 객실 잔액을 투숙객이 다시 지불하는 일을 방지할 수 있습니다.

수집 모드가 스위치를 제어합니다

객실 수집이 수집하지 않음이면 AVA는 객실 스위치를 비활성화하고 지웁니다. 보증금 수집이 사전 승인 보류가 아니면 보증금 스위치를 비활성화하고 지웁니다.

AVA가 사전 승인을 요청하는 경우

결제 초대와 숙박 일정이 유효 기간에 포함될 때만 AVA가 사전 승인을 요청합니다. 도착 전 일수와 숙박 일수의 합은 유효 기간보다 작아야 합니다. 날짜가 만료 경계와 같으면 AVA는 요청을 건너뜁니다.

객실 결제 시점 이해하기

현재 페이지에는 별도의 직접 판매 시점 제어 기능이 없습니다. 객실 결제 초대는 예약된 도착 전 이메일을 따릅니다.

1. 설정 → 결제 → 도착 전 온라인 결제를 엽니다.

2. 첫 번째 예약 이메일과 발송 시간을 확인합니다.

3. 구성을 클릭하여 도착 전 이메일에서 일정을 조정합니다.

4. 시나리오 표의 예약된 모든 이메일을 검토합니다.

   ✓ AVA는 대상 객실 및 보증금 초대에 예약된 이메일 흐름을 사용합니다.

사전 승인 시점

도착 전 결제 스위치는 기본적으로 꺼져 있습니다. 기본 사전 승인 유효 기간(일) 값은 7입니다. 이메일 시점과 숙박 기간이 해당 유효 기간에 포함되면 AVA가 사전 승인을 요청합니다.

결제 유형 및 제외 항목

도착 전 결제는 지원되는 온라인 게이트웨이를 사용합니다. 도착 전 과정에서는 대상 객실을 하나의 온라인 결제 견적으로 묶을 수 있습니다. AVA는 결제를 생성할 때 선택한 각 객실을 다시 확인합니다. 터미널 및 현금 결제 방법은 계속 제외됩니다. 도착 전 과정에서는 QR 및 터미널 결제 생성을 거부합니다. 선택한 상세 또는 간소화 청구서 보기가 보증금 요약을 제어합니다. 직접 판매 객실 결제는 활성화된 경우 객실 수집을 따릅니다. 보증금 결제는 계속 사전 승인 유효 기간 규칙을 따릅니다.

사전 승인 시나리오 읽기

표에는 예약된 각 도착 전 이메일에 대해 1박부터 10박까지 표시됩니다. 해당 이메일 시점에 은행 보류가 유효한지 확인할 수 있습니다.

표 열	의미
숙박 일수	1박부터 10박까지의 투숙객 숙박 기간
체크아웃까지 일수	도착 전 예약 이메일 발송 일수와 숙박 일수의 합
사전 승인을 요청하시겠습니까?	보류가 설정된 유효 기간에 포함되는지 여부

총합이 **사전 승인 유효 기간(일)**보다 작으면 AVA는 **✅**를 표시합니다. 총합이 유효 기간 경계에 도달하거나 초과하면 **❌**를 표시합니다. 여러 이메일을 사용하는 경우 예약 이메일마다 자체 결과가 표시됩니다.

예를 들어 도착 5일 전에 첫 번째 이메일을 보내고 2박을 숙박하면 7일입니다. 유효 기간이 8일이면 AVA는 해당 시나리오에 **✅**를 표시합니다.

이메일 일정 없음

도착 전 이메일 일정을 사용할 수 없거나 비활성화되어 있으면 카드에서 첫 번째 초대를 예상할 수 없습니다. 이메일 메시지 옆의 구성을 열어 일정을 설정하세요.

장기 투숙 차단 시 스위치가 비활성화됩니다

도착 전 → 장기 투숙 예약 차단이 활성화되어 있으면 AVA는 두 스위치를 모두 비활성화합니다. AVA는 저장된 도착 전 결제 선택도 지웁니다. 도착 전 온라인 결제를 활성화하기 전에 해당 규칙을 끄세요.

도착 전 결제 설정을 사용할 수 없음

보이는 현상: 스위치가 비활성화되어 있거나 카드에 수집을 사용할 수 없다고 표시됩니다.

해결 방법:

1. 설정 → 결제에서 게이트웨이가 연결되었는지 확인합니다.
2. 객실 결제를 활성화하기 전에 객실 수집을 사전 승인 보류 또는 직접 판매 청구로 설정합니다.
3. 보증금 결제를 활성화하기 전에 보증금 수집을 사전 승인 보류로 설정합니다.
4. 설정 → 체크인 → 체크인 정책을 엽니다.
5. 적절한 경우 도착 전 → 장기 투숙 예약 차단을 끕니다.
6. 설정 → 결제로 돌아가 다시 저장합니다.

기존 결제 완료 상태

AVA는 기존 결제 완료 상태를 수용합니다. 관련 객실 또는 보증금 결제가 이미 완료되었으면 두 번째 결제를 요청하지 않습니다.

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

Opera의 경우 Opera PMS 결제 매핑에서 다음 필드를 설정합니다.

1. 다음을 설정합니다.
   • 정산 코드
   • 기본 캐셔 ID
   • 기본 댓글 유형 / 위치
   • 결제 유형과 결제 방법 코드 행
2. Opera 결제 매핑 저장을 클릭합니다.

AVA는 활성 Opera 숙소에서 이 선택 항목을 읽습니다. AVA는 각 목록을 최대 30일 동안 인스턴스별로 별도로 캐시합니다. 최신 코드가 필요하면 OPERA에서 새로 고침을 클릭하세요. 목록을 새로 고치면 다른 설정 페이지의 필드를 포함하여 일치하는 모든 선택기도 업데이트됩니다.

매핑 행의 작동 방식

각 행은 하나의 AVA 결제 방법을 하나의 Opera 결제 방법 코드에 연결합니다. AVA는 드롭다운에 활성 Opera 결제 방법을 표시합니다. 목록에는 각 방법의 설명, 카드 유형 및 거래 코드가 포함됩니다. Opera 결제 방법 목록을 별도로 관리할 필요는 없습니다. AVA는 이 행을 다른 결제 설정과 함께 저장합니다.

Opera 코드 목록

정산 코드는 Opera 거래 코드를 사용합니다. 기본 캐셔 ID는 Opera 숙소의 활성 캐셔를 사용합니다. 결제 방법 행에는 활성 Opera 결제 방법만 사용할 수 있습니다. 예약 메모 설정은 별도의 Opera 댓글 유형 및 위치 목록을 사용합니다. 각 목록은 별도로 로드되므로 하나를 사용할 수 없어도 다른 목록이 숨겨지지 않습니다. 목록을 사용할 수 없어도 AVA는 다른 목록을 계속 사용할 수 있게 합니다. 사용할 수 없는 목록을 사용하는 필드는 수동 입력을 위해 편집할 수 있습니다.

오래된 매핑 복구

Opera 카드 결제의 경우 AVA는 먼저 신뢰할 수 있는 Vouch Core 매핑을 읽습니다. 따라서 방금 저장한 매핑을 결제 게시 전에 사용할 수 있습니다. Core를 일시적으로 사용할 수 없으면 AVA는 최근의 유효한 로컬 매핑을 사용할 수 있습니다. 사용 가능한 Opera 매핑을 찾지 못하면 AVA는 구성을 한 번 새로 고칩니다. Opera 결제 요청이 전송되지 않은 경우에만 AVA가 결제를 재시도합니다.

저장된 코드 확인

Opera가 더 이상 제공하지 않는 저장된 코드는 유지되지만 사용할 수 없음으로 표시됩니다. 해당 코드를 사용하는 결제는 Opera에 게시되지 않습니다. 결제를 받기 전에 표시된 코드를 활성 선택 항목으로 바꾸세요.

이전 web-be-pms 버전

Opera 서비스가 정산 코드를 제공하지 않으면 해당 필드는 자유 입력으로 유지됩니다. 사용 가능한 다른 목록은 계속 드롭다운을 사용할 수 있습니다.

Opera 결제 댓글 기본값

AVA는 Opera 결제 또는 보증금 댓글을 생성할 때 구성된 기본 댓글 유형 / 위치를 보냅니다. 이 값을 변경한 후 매핑을 다시 저장하세요. 이 설정은 직원 예약 메모를 제어하지 않습니다.

기능 기반 사용 가능 여부

매핑 섹션에 Opera 전용 문구가 표시될 수 있습니다. 표시 여부는 활성 PMS 통합의 결제 매핑 기능을 따릅니다.

Mews 결제 방법 매핑 구성

캡처된 방법을 활성화된 특정 Mews 결제 범주 아래에 표시해야 할 때 Mews 매핑을 사용합니다. 구성되지 않은 방법은 일반 AVA 게시 동작을 유지합니다.

1. 설정 → 기본 → PMS 통합에서 Mews가 활성 PMS인지 확인합니다.

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

3. Mews 결제 방법 매핑을 찾습니다.

4. 현재 결제 카탈로그에서 원본 결제 방법을 선택합니다. 원본에는 PromptPay, 카드 브랜드, 지갑 또는 사용자 지정 원본 코드가 포함될 수 있습니다.

5. 대상에서 활성화된 Mews 외부 결제 범주를 선택합니다.

6. 다른 원본 방법에 대해서만 행을 추가합니다.

7. 저장을 클릭합니다.

   ✓ AVA는 저장 전에 정규화된 각 원본을 한 번씩 검증합니다. ✓ 이후 Vouch 게시에서는 선택한 Mews 범주를 사용합니다.

먼저 Mews 범주를 확인하세요

대상 범주는 Mews에서 해당 숙소에 활성화되어 있어야 합니다. 재정의를 저장하기 전에 Mews 관리자에게 활성화를 요청하세요. 새 매핑은 기존 결제 기록을 변경하지 않습니다.

재정의 지우기

원본 행을 제거하고 저장하면 해당 방법의 기본 게시 동작이 복원됩니다. 이는 이후 Vouch 게시에만 영향을 줍니다. 기존 기록은 Mews 또는 회계 보고서에서 별도로 검토하세요.

Furama 결제 방법 매핑 구성

캡처된 결제에 활성 Furama iPMS 결제 유형을 사용해야 할 때 Furama 매핑을 사용합니다. 결제 재정의를 지원하는 연결된 Furama 숙소에 매핑 카드가 표시됩니다.

1. 설정 → 기본 → PMS 통합에서 Furama iPMS가 활성 상태인지 확인합니다.

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

3. 결제 방법 매핑을 찾습니다.

4. 각 결제 방법의 기록 유형에서 Furama 결제 유형을 선택합니다. 카드 방법은 Visa 또는 Amex와 같은 브랜드별로 매핑됩니다. 현금과 같은 이름이 지정된 비카드 방법은 방법별로 매핑됩니다.

5. 결제 게이트웨이 설정 저장을 클릭합니다.

6. 필요한 경우 Furama PMS 설정에서 **기본 결제 유형 코드(선택 사항)**를 설정합니다.

7. PMS 설정 저장을 클릭합니다.

   ✓ 명시적 매핑이 먼저 사용됩니다. ✓ 기본 코드는 명시적 매핑이 없는 결제 방법을 처리합니다. ✓ 두 설정이 모두 없으면 AVA는 게시하기 전에 매핑되지 않은 결제를 거부합니다.

Furama 코드를 확인하세요

Furama 카탈로그는 제어 단위 전체에서 공유되며 다른 호텔의 코드가 포함될 수 있습니다. Furama 관리자가 확인한 활성 코드를 선택하세요.

Furama 매핑 지우기

해당 결제 방법의 재정의를 제거하려면 기본값 사용을 선택하고 저장합니다. 이는 이후 게시에만 영향을 줍니다.

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단계: Auto Delay Capture 구성

PMS가 지연 캡처를 지원할 때 Auto Delay Capture를 사용합니다. AVA는 Stripe 사전 승인이 만료되기 전에 객실 요금을 캡처합니다. 보증금은 캡처되지 않은 상태로 유지됩니다.

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

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

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

3. Auto Delay Capture 활성화를 켭니다.

4. Auto Delay Capture 만료 일수를 입력합니다.

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

   ✓ 사전 승인이 유효하게 유지되면 AVA는 만료 전에 객실 요금을 캡처합니다.

기능 기반 표시

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

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

지연 캡처를 지원하지 않는 PMS로 전환하면 AVA는 Auto Delay Capture를 끕니다. AVA는 오래된 설정이 사용되지 않도록 만료 일수 값도 지웁니다.

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

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

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

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

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

4. 부대 요금 / 보증금 일체 수집 안 함에 일치하는 각 요금 코드, 시장 세그먼트, 보증 유형 또는 댓글을 추가합니다.

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

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

Opera 결제 댓글

AVA는 결제 또는 보증금을 게시하기 전에 Opera 예약 댓글을 추가하려고 시도합니다. 댓글 생성에 실패해도 AVA는 Streamliner에서 결제 또는 보증금을 게시합니다. 따라서 Opera 댓글 생성에 실패해도 결제 수집을 계속할 수 있습니다. 숙박 요금 정책은 위에서 구성합니다.

반올림 조정 종속성

체크아웃 반올림이 결제 동작에 영향을 주도록 하려면 다음을 수행합니다.

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

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

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

4. 결제 정책 제어를 열고 반올림 조정 활성화를 설정합니다.

   ✓ 두 정책 중 하나가 켜져 있을 때만 AVA가 반올림 설정을 적용합니다.

저장된 값은 유지됨

나중에 체크인 잔액 정책을 모두 끄면 AVA는 저장된 반올림 값을 유지합니다. 제어 기능이 결제 동작에 영향을 주지 않을 뿐입니다.

저장 후 예상되는 결과

• ✅ 설정 후 연결된 게이트웨이 세부 정보가 표시됨
• ✅ 연결 상태 배지에 Stripe Live 또는 Test가 표시됨
• ✅ 청구서 보기가 다른 결제 설정과 함께 저장됨
• ✅ 보증금이 활성화되면 보증금 필드가 표시됨
• ✅ 사전 승인 보류는 보증금 금액이 0보다 클 때만 저장됨
• ✅ 저장을 클릭한 후에도 보증금 통화가 저장된 상태로 유지됨
• ✅ Auto Delay Capture는 활성 PMS가 지원할 때만 표시됨
• ✅ 활성 PMS가 지원을 보고하면 PMS 결제 매핑이 표시됨
• ✅ Opera PMS에서만 Opera 정책 섹션이 표시됨
• ✅ 통합에서 지원을 보고하면 Opera가 아닌 PMS에서도 결제 매핑 카드가 표시될 수 있음
• ✅ 결제 설정은 같은 페이지에서 독립적으로 저장됨

마이그레이션 참고

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

문제 해결

결제 값 검증 실패

보이는 현상: AVA가 결제 필드를 잘못된 것으로 표시하거나 MCP가 valid: false를 반환합니다.

해결 방법:

1. 보증금 통화에는 대문자 3글자를 사용합니다.

2. 반올림 임계값에는 0 이상을 입력합니다.

3. 반올림 코드와 만료 일수에는 0 이상의 정수를 입력합니다.

4. 필드를 수정한 다음 저장을 클릭합니다.

5. MCP의 경우 업데이트를 적용하기 전에 settings_validate를 다시 실행합니다.

   ✓ 저장하거나 변경 사항을 적용하기 전에 검증 결과에 valid: true가 표시되어야 합니다.

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

보이는 현상: 결제 토글 또는 저장 버튼이 비활성화되어 있습니다.

해결 방법:

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

청구서 보기가 변경되지 않음

보이는 현상: 투숙객에게 이전 청구서 요약 레이아웃이 계속 표시됩니다.

해결 방법:

1. 설정 → 결제로 돌아갑니다.
2. 상세 또는 간소화를 다시 선택합니다.
3. 청구서 보기 카드에서 저장을 클릭합니다.
4. 새로운 투숙객 흐름을 시작하거나 예약 화면을 새로 고칩니다.
5. 여전히 잘못 표시되면 호텔이 현재 CCI 설정 경로를 사용하는지 확인합니다.

Stripe 환경이 잠김

보이는 현상: Stripe 연결 후 환경 드롭다운이 비활성화됩니다.

해결 방법:

1. Stripe 연결을 해제합니다.
2. 고급을 엽니다.
3. Live 또는 Test를 선택합니다.
4. Stripe를 다시 연결합니다.

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

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

해결 방법:

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

수동 Stripe 게이트웨이 저장이 거부됨

보이는 현상: AVA가 수동 Stripe 게이트웨이 저장을 거부합니다.

해결 방법:

1. 설정 → 결제 → 결제 게이트웨이 통합을 엽니다.

2. 환경을 Test로 설정합니다.

3. 공개 가능 키, 비밀 키, 웹훅 비밀 세 필드를 모두 제공합니다.

4. 기존 자격 증명을 다시 저장할 때 마스킹된 값은 변경하지 않습니다.

5. 결제 게이트웨이 설정을 다시 저장합니다.

   ✓ AVA가 완전한 테스트 구성을 저장합니다. ✓ 저장이 거부되어도 기존 자격 증명을 대체하지 않습니다.

Stripe 테스트 자격 증명이 표시되지 않음

보이는 현상: 게이트웨이 또는 터미널 카드에서 수동 Stripe 필드가 없습니다.

해결 방법:

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

결제 정책 제어가 표시되지 않음

보이는 현상: 숙박, 체크아웃 반올림, 지연 캡처 또는 Opera 전용 결제 제어가 없습니다.

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. 활성 PMS가 올바른지 확인합니다.
3. 설정 → 결제로 돌아갑니다.
4. 페이지를 한 번 새로 고칩니다.
5. 관리자에게 PMS 기능이 활성화되어 있는지 확인해 달라고 요청합니다.

PMS 결제 매핑

활성 PMS가 지원을 보고하면 결제 매핑이 표시됩니다. 현재 Opera가 이 기능을 보고합니다. 매핑 섹션은 다른 기능 기반 결제 정책 제어와 별개입니다.

Auto Delay Capture가 없음

보이는 현상: 사전 승인 제어에 Auto Delay Capture가 표시되지 않습니다.

해결 방법:

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

PMS가 지원을 보고하지 않으면 제어 기능은 숨겨진 상태로 유지됩니다. 이는 정상적인 동작입니다.

Auto Delay Capture 설정이 거부됨

보이는 현상: 결제 설정을 저장할 때 AVA가 지연 캡처를 사용할 수 없다고 말합니다.

해결 방법:

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

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

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

보이는 현상: 저장을 클릭한 후 캐셔 또는 결제 방법 행이 사라집니다.

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. 올바른 PMS가 활성 상태이고 결제 매핑 지원을 보고하는지 확인합니다.
3. 설정 → 결제로 돌아갑니다.
4. 기본 캐셔 ID와 각 매핑 행을 다시 입력합니다.
5. Opera 결제 매핑 저장을 다시 클릭합니다.

Mews 매핑 옵션을 사용할 수 없음

보이는 현상: Mews 매핑 카드가 없거나 원본 및 대상 옵션이 로드되지 않습니다.

해결 방법:

1. Mews가 활성 PMS인지 확인합니다.
2. Mews 로드가 완료된 후 설정 → 결제를 새로 고칩니다.
3. 결제 카탈로그와 Mews 구성을 사용할 수 있는지 확인합니다.
4. 카드가 계속 표시되지 않으면 지원팀에 문의합니다.

AVA는 현재 원본 및 대상 옵션을 검증할 수 있을 때까지 변경을 비활성화합니다.

Mews 결제 범주를 사용할 수 없음

보이는 현상: AVA가 선택한 Mews 결제 범주를 거부합니다.

해결 방법:

1. Mews 관리자에게 해당 범주를 숙소에 활성화해 달라고 요청합니다.
2. 설정 → 결제를 새로 고칩니다.
3. 새로 고친 목록에서 활성화된 범주를 선택합니다.
4. 매핑을 다시 저장합니다.

매핑이 성공적으로 저장될 때까지 결제를 다시 시도하지 마세요.

Furama 결제 매핑 옵션을 사용할 수 없음

보이는 현상: Furama 매핑 카드가 없거나 결제 옵션이 로드되지 않습니다.

해결 방법:

1. Furama iPMS가 활성 PMS인지 확인합니다.
2. Furama 연결이 저장되어 있는지 확인합니다.
3. 설정 → 결제를 새로 고칩니다.
4. 설정 → 기본 → PMS 통합에서 제어 단위를 확인합니다.
5. Furama 관리자에게 결제 카탈로그를 사용할 수 있는지 확인해 달라고 요청합니다.

AVA는 현재 원본 및 대상 옵션을 읽을 수 있을 때까지 매핑 변경을 비활성화합니다.

Furama가 결제 유형을 거부함

보이는 현상: AVA가 게시를 시작한 후 Furama가 결제를 거부합니다.

해결 방법:

1. 결제 방법 매핑을 새로 고칩니다.
2. 대상을 활성 Furama 결제 유형으로 바꿉니다.
3. 코드가 해당 숙소의 제어 단위에 속하는지 확인합니다.
4. 필요한 경우 매핑되지 않은 방법에 대해 **기본 결제 유형 코드(선택 사항)**를 설정합니다.
5. 두 설정 페이지를 모두 저장합니다.
6. 결제를 한 번 다시 시도합니다.

비활성으로 표시된 코드나 다른 숙소의 카탈로그에 속한 코드를 사용하지 마세요.

결제 중 Opera 결제 매핑이 없음

보이는 현상: 카드 브랜드 매핑이 없어 Opera 결제를 시작할 수 없습니다.

발생 이유: AVA에 최신 공유 Opera 구성 목록이 없을 수 있습니다.

해결 방법:

1. AVA가 자동 구성 새로 고침을 완료할 때까지 기다립니다.

2. AVA에 오류가 계속 표시될 때만 결제를 다시 시도합니다.

3. 설정 → 결제에서 Opera PMS 결제 매핑을 확인합니다.

4. 카드 브랜드에 일치하는 결제 방법 코드가 있는지 확인합니다.

5. 매핑이 있는데도 결제를 시작할 수 없으면 지원팀에 문의합니다.

   ✓ AVA는 Opera 결제 요청을 보내기 전에 이 새로 고침을 한 번 수행합니다.

Opera 코드 목록이 비어 있음

보이는 현상: 캐셔, 정산 코드, 댓글 유형, 댓글 위치 또는 결제 방법 목록이 비어 있습니다.

해결 방법:

1. 활성 PMS가 Opera인지 확인합니다.
2. Opera에 코드가 존재하고 활성 상태인지 확인합니다.
3. 설정 → 결제를 새로 고칩니다.
4. 적절한 경우 사용 가능한 다른 코드를 선택합니다.
5. 목록이 계속 비어 있으면 Opera 관리자에게 문의합니다.

AVA는 각 목록을 독립적으로 로드합니다. 다른 매핑 필드는 계속 구성할 수 있습니다.

OPERA에서 코드를 로드하지 못함

보이는 현상: AVA에 "OPERA에서 코드를 로드할 수 없습니다."가 표시됩니다.

해결 방법:

1. Opera가 활성 PMS인지 확인합니다.
2. Opera 연결이 구성되어 작동하는지 확인합니다.
3. Opera PMS 결제 매핑에서 다시 시도를 클릭합니다.
4. AVA에서 필드를 편집할 수 있게 유지하면 코드를 수동으로 입력합니다.
5. 목록을 계속 사용할 수 없으면 지원팀에 문의합니다.

새로 고침에 실패하면 AVA는 이전에 읽은 코드를 유지하고 새로 고침 경고를 표시합니다. Opera가 일부 응답을 반환하면 AVA는 성공한 목록을 유지하고 누락된 목록만 사용할 수 없음으로 표시합니다. Opera가 사용할 수 없다고 표시하지 않는 한 유효한 저장 매핑을 바꾸지 마세요.

Opera 결제 통화가 일치하지 않음

보이는 현상: Opera에 내부 오류가 표시되거나 게시 후 결제 또는 보증금이 나타나지 않습니다.

해결 방법:

1. 설정 → 기본 → 호텔 기본 정보에서 숙소 통화를 확인합니다.
2. Opera 예약이 동일한 통화를 사용하는지 확인합니다.
3. 결제 또는 보증금을 다시 시도합니다.
4. Opera가 계속 내부 오류를 반환하면 지원팀에 문의합니다.

Opera 예약 댓글이 없음

보이는 현상: 결제는 성공적으로 게시되었지만 Opera에서 새 예약 댓글이 보이지 않습니다.

해결 방법:

1. Streamliner에서 결제 또는 보증금이 성공적으로 완료되었는지 확인합니다.
2. Opera 예약에 일치하는 결제 기록이 있는지 확인합니다.
3. Opera PMS 결제 매핑에서 기본 댓글 유형 / 위치가 설정되어 있는지 확인합니다.
4. 댓글을 다시 만들기 위해 결제만 재시도하지 마세요.
5. 결제가 게시되었는데도 댓글이 나타나지 않으면 지원팀에 문의합니다.

Opera 댓글 유형 또는 위치가 잘못 표시됨

보이는 현상: Opera가 결제 댓글을 만들었지만 유형 또는 위치가 예상과 다릅니다.

해결 방법:

1. 설정 → 결제를 엽니다.
2. Opera PMS 결제 매핑을 확인합니다.
3. 기본 댓글 유형 / 위치를 확인합니다.
4. 매핑을 다시 저장합니다.
5. 다른 Opera 결제 또는 보증금을 테스트합니다.

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

보이는 현상: 결제 요청이 예상되지만 예약에서 객실 결제를 건너뜁니다.

해결 방법:

1. PMS에서 예약을 엽니다.
2. 예약 댓글, 소스 이름 및 Opera 여행사 라벨을 확인합니다.
3. 예약을 면제하면 안 되는 경우 일치하는 값을 제거하거나 변경합니다.
4. AVA를 새로 고치고 새 예약으로 다시 테스트합니다.

숙박 정책 제어를 사용할 수 없음

보이는 현상: 숙박 요금 정책이 보이지 않거나 AVA에 지원되지 않는 PMS 메시지가 표시됩니다.

해결 방법:

1. PMS 제공업체가 숙박 결제 정책을 지원하는지 확인합니다.
2. 설정 → 결제를 새로 고칩니다.
3. 제어 기능이 계속 표시되지 않으면 AVA에 아직 해당 PMS의 지원 데이터가 없는 것입니다.
4. 기존 정책 값을 유지합니다. 편집기가 숨겨져 있어도 AVA는 계속 값을 저장합니다.

청구 행이 PMS와 일치하지 않음

보이는 현상: AVA에서 객실, 세금, 보증금 또는 부대 요금 행이 다르게 표시됩니다.

해결 방법:

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

Mews 포함 상품 검토 필요

보이는 현상: 일치하는 객실 패키지 면제 후 번들 Mews 상품의 검토가 필요합니다.

발생 이유: AVA가 상품의 분류를 입증하지 못했습니다.

해결 방법:

1. 직원 액세스를 통해 예약을 엽니다.
2. Mews에서 예약 요금, 포함 상품 및 전체 청구서를 검토합니다.
3. 예약이 구성된 숙박 정책과 일치하는지 확인합니다.
4. AVA에서 예약을 새로 고칩니다.
5. 검증되지 않은 금액을 수집하지 마세요.
6. 프런트 데스크 직원에게 전체 Mews 청구서를 검토하도록 요청합니다.

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

보이는 현상: 예약 조회 후 투숙객이 계속 진행할 수 없습니다. AVA가 투숙객에게 프런트 데스크로 가라고 요청합니다.

발생 이유: 결제 정책이 일치했지만 Mews가 관리 대상 요금을 분류하지 못했습니다.

해결 방법:

1. Mews 요금, 포함 상품 및 전체 청구서를 검토합니다.
2. 숙박 요금 정책에서 일치하는 값을 확인합니다.
3. Mews가 동기화를 완료한 후 예약을 새로 고칩니다.
4. 전체 Mews 청구서로 지불 가능 금액을 확인합니다.
5. 검토가 계속 필요하면 프런트 데스크 직원에게 체크인을 완료하도록 요청합니다.

검증되지 않은 금액을 수집하지 마세요.

투숙객에게 결제 요청이 표시되지 않음

보이는 현상: 투숙객이 체크인 중 결제를 건너뜁니다.

해결 방법:

1. 게이트웨이가 연결되어 있는지 확인합니다.
2. 보증금 수집 또는 전액 결제 수집이 활성화되어 있는지 확인합니다.
3. ACI의 경우 설정 → 체크인 → 체크인 정책 → 키오스크 및 결제에서 Assisted Check-In 직원의 결제 수집 허용이 켜져 있는지 확인합니다.
4. 예약에 미결제 잔액이 있는지 확인합니다.
5. 저장하고 샘플 예약으로 다시 테스트합니다.

ACI 전용 스위치

ACI 스위치는 Self Check-In 또는 도착 전 결제 요청을 변경하지 않습니다.

보증금 금액 0을 저장할 수 없음

보이는 현상: 보증금 금액이 비어 있거나 0이어서 AVA가 결제 설정을 거부합니다.

발생 이유: 사전 승인 보류에는 양수 금액이 필요합니다.

해결 방법:

1. 설정 → 결제 → 보증금 및 부대 요금을 엽니다.
2. 보증금 금액에 0보다 큰 금액을 입력합니다.
3. 결제 게이트웨이 설정 저장을 클릭합니다.

보증금을 수집하지 않으려면 수집하지 않음을 선택합니다. 인라인 오류에서 대신 "수집하지 않음"으로 전환을 클릭할 수도 있습니다.

✓ AVA는 안전한 수집 선택을 저장하고 0 값의 보류 요청을 중지합니다.

보증금 통화가 잘못되었거나 편집할 수 없음

보이는 현상: 보증금 통화가 예상 설정과 다르거나 필드 변경이 유지되지 않습니다.

해결 방법:

1. 설정 → 기본 → 호텔 기본 정보를 엽니다.
2. 숙소 통화가 PMS에서 관리되는지 또는 편집 가능한지 확인합니다.
3. PMS에서 관리되면 PMS에서 통화를 업데이트하고 동기화를 기다립니다.
4. 설정 → 결제를 새로 고치고 통화를 확인합니다.

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

보이는 현상: 반올림 조정 활성화가 표시되지 않습니다.

해결 방법:

1. 설정 → 기본 → PMS 통합을 엽니다.
2. 활성 PMS 제공업체를 확인합니다.
3. AVA와 Opera는 체크아웃 반올림을 지원합니다.
4. Cloudbeds, Mews, eZee 및 Furama는 현재 지원하지 않습니다.
5. PMS 연결을 변경한 후 설정 → 결제를 새로 고칩니다.
6. AVA 또는 Opera에서 여전히 제어 기능을 숨기면 지원팀에 문의합니다.

반올림 조정이 비활성 상태로 유지됨

보이는 현상: 반올림 조정이 회색으로 표시되거나 저장된 값이 결제 동작을 바꾸지 않습니다.

해결 방법:

1. 설정 → 체크인 → 체크인 정책을 엽니다.
2. 체크인 미결제 잔액 차단 또는 체크아웃 잔액 정산을 켭니다.
3. 설정을 저장합니다.
4. 설정 → 결제로 돌아가 반올림 값이 계속 저장되어 있는지 확인합니다.

아직 해결되지 않았나요?

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

• ❌ 설정을 다시 저장한 후에도 결제가 계속 실패함
• ❌ 투숙객에게 청구서 보기 변경 사항이 표시되지 않음
• ❌ 지원되는 PMS에서 지연 캡처 제어를 계속 사용할 수 없음
• ❌ Opera 매핑 값이 유지되지 않음
• ❌ Mews 매핑 옵션 또는 결제 범주를 계속 사용할 수 없음
• ❌ Stripe 또는 Red Dot 연결이 반복적으로 해제됨

함께 제공하면 유용한 정보:

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

관련 가이드

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