예약 결제 관리

빠른 설정

예약 모달에서 Payments를 사용하세요. 대부분의 확인 작업은 3분 이내에 완료됩니다.

이 가이드에서는 잔액을 검토하고, 결제를 캡처하고, 폴리오 세부 정보를 확인하는 방법을 설명합니다.

항목	표시 내용	사용 위치
Payment Summary	결제 완료 금액, 사전 승인, 거래 ID	예약 카드
Folio Details	미결제 잔액, 청구 내역, 보증금, 결제 내역	예약 모달
Capture Payment	승인된 결제 캡처	예약 모달
Source	폴리오 항목의 출처	폴리오 패널

결제 수금 작동 방식

• 결제 규칙은 Settings → Payment에서 가져옵니다.
• 숙소 통화는 Settings → Essentials → Hotel Basic Details에서 가져옵니다.
• 숙소는 보증금, 객실 결제, 체크아웃 결제 또는 세 가지 모두를 수금할 수 있습니다.
• 잔액이 남아 있으면 AVA가 체크아웃 중에 체크아웃 청구를 표시할 수 있습니다.
• 결제 수금이 꺼져 있으면 체크인에서 결제를 건너뜁니다.
• 백엔드 포털에는 결제 게이트웨이의 결제 데이터가 표시됩니다.
• 평가된 결제 대상 잔액이 양수로 유지되면 AVA가 체크아웃 결제를 요청할 수 있습니다.
• PMS가 청구 금액을 평가하지 않으면 AVA는 일반 요약 또는 저장된 잔액을 사용합니다.
• 검증된 Mews 요금 포함 상품은 객실 패키지 면제 규칙을 따를 수 있습니다.
• Mews 숙박 면제 후 양수인 THB 0.01 반올림 잔액은 모든 양수 청구 섹션이 숙박 요금일 때 AVA가 숨깁니다.
• 실제 Mews 추가 요금과 분류되지 않은 청구는 실제 THB 0.01 추가 요금을 포함하여 결제 대상에 남습니다.
• 숙소에서 PMS 단말 결제를 사용하는 경우 AVA는 PMS 단말 흐름을 통해 예약 사전 승인을 전송합니다.
• 지원되는 AVA 및 Opera PMS 연결은 소액 잔액에 체크아웃 반올림을 적용할 수 있습니다.

결제 정보 보기

예약 카드의 결제 요약

카드 보기에서 예약을 확인하면 각 카드에 다음이 표시됩니다.

• Paid: 예약에 대해 결제된 총액
• Pre-auth: 해당되는 경우 사전 승인된 금액
• Transaction ID: 결제 게이트웨이 참조 번호와 복사 버튼

결제 데이터를 사용할 수 있으면 이 요약이 자동으로 표시됩니다.

Payment Summary에 표시되는 통화

AVA는 예약 표시 통화로 Paid와 Pre-auth를 먼저 표시합니다. 해당 통화가 없으면 AVA는 결제 요약 통화를 사용합니다. 둘 다 없으면 숙소 통화로 대체합니다.

Opera 예약 카드

Opera를 사용하는 경우 예약 카드에 최대 30초 동안 캐시된 잔액이 표시될 수 있습니다. 새 결제 후 실시간 잔액을 확인하려면 예약 모달을 여세요.

Command Center의 결제 단계

결제 통합이 활성화되면 Command Center는 체크인 및 체크아웃 흐름에 결제 단계를 표시합니다.

• Check-In Payment Stage: 체크인 진행 상황의 배지
• Checkout Payment Stage: 체크아웃 결제가 여전히 적용되는 경우 체크아웃 진행 상황의 배지
• 배지는 대기 중 또는 완료와 같은 상태 표시기를 보여 줍니다

노트

결제 단계는 결제 통합이 활성화된 경우에만 표시됩니다. 이 값이 "DISABLE"이면 체크인과 체크아웃에서 결제 단계를 건너뜁니다. 결제 없이 완료되었거나 잔액이 0인 체크아웃이 끝난 후에는 체크아웃 결제도 계속 숨겨집니다. AVA가 체크아웃 결제 시도를 기록했다면 단계는 계속 표시됩니다. Room Payment 배지는 체크인 객실 결제 또는 사전 승인 증거만 추적합니다. 체크아웃 결제에는 Room Payment 배지를 사용하지 않습니다.

예약 모달의 상세 결제 정보

예약을 클릭하면 예약 세부 정보 모달이 열립니다. 이 보기는 다음 위치에서 열 수 있습니다.

• Check-Ins page: 예약 카드 또는 표의 행 클릭
• Checkouts page: 체크아웃 카드 클릭
• Stayovers page: 스테이오버 카드 클릭
• Calendar view: 예약 블록 클릭
• Command Center page: 예약 클릭

Financials에서 다음을 검토합니다.

• Balance Due: 현재 미결제 잔액
• Deposit Payment: 수금된 보증금 세부 정보
• Room Payment: 객실 요금 세부 정보

PMS가 평가된 결제 대상 금액을 반환하면 Balance Due는 해당 금액을 사용합니다. 그렇지 않으면 Balance Due는 PMS 폴리오 요약 또는 저장된 스냅샷에서 가져옵니다. 예약 모달은 단일 예약의 현재 잔액을 가져옵니다. PMS가 AVA인 경우 Streamliner도 보증금과 객실 결제를 폴리오 원장에 동기화합니다. 동기화는 결제 요약, 청구 보기 및 캡처 흐름 중에 수행됩니다. AVA가 청구 규칙을 적용하면 숨겨진 객실 및 세금 행에 ✅가 표시됩니다. 평가된 경우 결제 대상 금액은 숫자로 유지되며 결제를 제어합니다. Opera 객실 패키지 면제에서는 AVA가 먼저 객실 요금, 객실 서비스 요금 및 객실 GST를 면제합니다. 도착 전 Opera 예상 청구에서는 예상 객실 요금과 해당 요금 정보의 세금을 함께 면제합니다. 별도로 게시된 추가 요금과 해당 세금은 계속 수금할 수 있습니다. 명시적인 Opera 잔액 0은 보이는 객실, 세금 또는 서비스 요금 행보다 우선합니다. 라우팅되었거나 정산된 대응 항목이 게스트 폴리오에 보이지 않는 경우에도 마찬가지입니다. AVA는 금액과 통화가 정규화된 Opera 청구서와 일치할 때만 해당 0을 신뢰합니다. 불일치는 미확인 상태로 남습니다. Opera 결제 취소는 청구 검토 중에도 음수 부호를 유지합니다. 따라서 동일한 금액의 결제와 취소는 폴리오 및 결제 대상 잔액에서 0이 됩니다. 검증된 Mews 요금 포함 상품(예: 조식 번들)은 숙박 면제를 따를 수 있습니다. 검증된 포함 상품에 연결된 상대 가격 청구도 해당 면제를 따를 수 있습니다. 숙박 면제 후 AVA는 야간 서비스 요금 반올림으로 발생한 양수 THB 0.01 잔액을 숨깁니다. 이는 모든 양수 청구 섹션이 숙박 요금인 경우에만 적용됩니다. 실제 추가 요금과 분류되지 않은 청구는 결제 대상에 남습니다. AVA가 분류를 입증할 수 없으면 검증되지 않은 금액을 직원 검토 대상으로 보류합니다. 결제를 수금하기 전에 금액을 실시간 Mews 청구서와 비교하세요.

검증된 결제 대상 판정

PMS가 평가된 결제 대상 판정을 반환하면 AVA는 객실 결제에 해당 판정의 금액과 통화를 사용합니다. 다른 이유로 판정이 평가되지 않으면 AVA는 저장된 스냅샷을 유지할 수 있습니다. Mews의 결론이 나지 않은 면제에는 검증되지 않은 금액을 사용하지 않습니다. 수금하기 전에 프런트 데스크 직원에게 전체 청구서를 검토하도록 요청하세요. 객실 결제 수금이 활성화되면 AVA는 예약 조회 중 게스트를 프런트 데스크로 안내할 수 있습니다.

Furama 다중 객실 청구

Furama는 각 객실을 별도의 PMS 주문으로 저장합니다. AVA는 숙박 전체 잔액을 위해 모든 객실의 청구와 결제를 합산합니다. 결제 또는 폴리오 청구를 게시하기 전에 선택한 객실의 행 또는 카드를 여세요. AVA는 해당 객실의 Furama 주문에 기록을 전송합니다. 객실을 식별할 수 없으면 AVA는 작업을 중지합니다.

Folio Details를 펼치면 다음을 검토할 수 있습니다.

• Room Charges
• Extras
• Taxes
• Adjustments
• Deposits
• Payments

청구 요약에서 Deposits와 Payments는 음수로 표시됩니다. 이는 표시 방식일 뿐이므로 Balance Due는 변경되지 않습니다. 청구서 기반 PMS 폴리오에는 Adjustments도 표시될 수 있습니다. 이는 PMS가 반환한 요금 변경 또는 보존 보정입니다. AVA는 이를 청구 섹션에 포함하므로 보이는 행이 표시된 잔액과 조정됩니다. 조정 금액은 세금 차감 순액일 수 있지만 PMS는 총액 감사 값을 유지합니다. 폴리오 합계를 확인할 때는 표시된 섹션 금액을 사용하세요. 일부 숙소에서는 간소화된 청구 요약 보기를 사용합니다. 이 경우 숨겨진 객실 및 세금 행이 표시됩니다. 또한 Extras 구분선이 표시됩니다. 추가 항목은 코드별로 그룹화됩니다. Room Charges, Tax 및 총액은 계속 표시됩니다.

폴리오 패널에는 Fidelity 배지, Last synced 및 Source 필드도 표시됩니다. Source 레이블은 원시 백엔드 토큰이 아니라 번역되어 표시됩니다. AVA ledger, Invoice-backed 또는 지역화된 레이블이 표시될 수 있습니다. PMS가 폴리오 세부 정보를 지원하지 않으면 AVA는 스냅샷 잔액을 유지하고 제공자 사유를 표시합니다.

각 결제 기록에는 다음이 표시됩니다.

• "Authorized" 또는 "Captured"와 같은 결제 상태
• 결제 금액과 통화
• 신용카드 또는 현금과 같은 결제 수단
• 결제 게이트웨이 이름
• 게이트웨이 참조 번호 또는 거래 ID
• 브랜드 및 마지막 4자리와 같은 카드 정보

수동 요금 변경 후 요금 조정 검토

직원이 PMS에서 예약 요금을 다시 계산하면 이전 요금 보존 조정이 남을 수 있습니다. 이 조정은 원래 객실 요금을 상쇄하지만 새 요금과 더 이상 일치하지 않을 수 있습니다. AVA는 이제 해당 행을 Adjustments 아래에 계속 표시합니다.

1. 예약의 Folio Details를 엽니다.

2. Adjustments를 펼치고 현재 객실 요금과 해당 행을 비교합니다.

3. PMS에서 예약을 열고 현재 요금과 조정을 확인합니다.

4. 더 이상 객실 요금을 상쇄하지 않으면 PMS에서 오래된 조정을 삭제합니다.

5. AVA에서 Folio Details를 새로 고칩니다.

   ✓ PMS가 업데이트된 후 폴리오 섹션과 Balance Due가 조정되어야 합니다.

두 번째 보정을 추가하지 마세요

설명되지 않는 잔액을 숨기기 위해 새 수동 할인을 게시하지 마세요. 먼저 PMS 요금과 기존 조정을 확인하세요.

결제 유형

AVA 백엔드 포털은 세 가지 결제 유형을 추적합니다.

1. Deposit Payment: 체크인 전 또는 체크인 중에 수금하는 선결제
2. Room Payment: 객실 요금 및 추가 서비스에 대한 결제
3. Checkout Payment: 체크아웃 중 수금하는 최종 정산

체크아웃 청구 검토

AVA가 체크아웃 청구를 열면 다음 안내 중 하나가 표시될 수 있습니다.

안내	의미	할 일
Existing balance	AVA가 보류 중이거나 열린 잔액을 찾음	금액을 확인하고 계속 진행
Different card	게스트가 다른 카드를 원함	새 결제 흐름 시작
Dispute	게스트가 요금에 이의를 제기함	호텔의 분쟁 처리 절차를 따름

결제 반환 처리

결제 페이지에서 AVA로 돌아오면 확인 메시지를 기다리세요. 체크아웃 화면은 완료되기 전에 새로 고쳐질 수 있습니다.

체크아웃 반올림 조정

PMS가 체크아웃 반올림을 지원하면 AVA는 소액의 체크아웃 잔액을 승인할 수 있습니다. 잔액은 구성된 Rounding Threshold 이내여야 합니다. 조정은 체크아웃이 완료되기 전에 게시됩니다.

PMS 제공자	필요한 작업
AVA	조정을 활성화합니다. 제공업체 코드는 필요하지 않습니다.
Opera / OHIP	조정을 활성화하고 **Transaction Code (Rounding)**에 제공업체 코드를 저장합니다.
Cloudbeds, Mews, eZee 및 Furama	PMS 또는 프런트 데스크에서 잔액을 정산합니다.

체크아웃 반올림 설정을 참조하세요.

단말 결제 재시도

단말이 체크아웃 결제를 승인하면 AVA는 즉시 상태 폴링을 시작합니다. 단말 결제가 이미 완료된 경우 AVA는 재시도 시 즉시 결제 완료 상태를 표시합니다. 이렇게 하면 동일한 활성 결제에 대한 중복 청구를 방지할 수 있습니다.

결제가 취소되었거나 결제 컨텍스트가 변경된 경우 AVA는 새 단말 흐름을 시작할 수 있습니다.

체크아웃 카드 교체

게스트가 Different card를 선택하면 AVA는 새 체크아웃 결제를 시작합니다. 해당 결제가 성공하면 AVA는 게이트웨이에서 이전의 재사용 가능한 체크아웃 사전 승인을 취소합니다. 이 취소는 백그라운드에서 수행되므로 체크아웃이 먼저 완료될 수 있습니다. 게이트웨이 콜백이 나중에 도착하면 동기화 후 이전 사전 승인이 해제됩니다.

PMS 단말 사전 승인

숙소에서 PMS 단말 결제를 사용하는 경우 AVA는 요청을 PMS 단말 흐름으로 전송합니다.

• AVA는 요청을 보내기 전에 결제 금액을 로컬에서 계산합니다.
• 기존 OPI 단말 설정도 계속 PMS Terminal로 작동합니다.
• 이 흐름은 예약 사전 승인 및 체크인 결제 단계에 사용합니다.
• 체크아웃은 계속 매핑된 Stripe 단말 또는 게이트웨이 흐름을 사용합니다.

결제 캡처

결제 게이트웨이가 지원하는 경우 모달에서 승인된 결제를 캡처할 수 있습니다.

1. 예약 세부 정보 모달을 엽니다.
2. Financials로 스크롤합니다.
3. 결제가 승인되었지만 캡처되지 않았다면 Capture Payment를 클릭합니다.
4. 캡처 작업을 확인합니다.
5. 결과가 업데이트될 때까지 기다립니다.

노트

캡처는 아직 캡처되지 않은 승인 결제에만 사용할 수 있습니다.

결제 캡처 결과

결제를 캡처한 후 포털에 다음이 표시됩니다.

• Payment captured: 예 또는 아니요
• Capture message: 게이트웨이에서 반환한 세부 정보 또는 오류 텍스트

결과가 즉시 표시되지 않으면 포털은 최대 60초 동안 폴링합니다.

결제 수금 전

1. PMS 또는 게스트 폴리오에서 예약 잔액을 확인합니다.
2. 이 예약에 필요한 결제 수단을 확인합니다.
3. Settings → Payment에서 결제 게이트웨이가 연결되어 있는지 확인합니다.
4. 결제 통합이 활성화되어 있고 "DISABLE"로 설정되어 있지 않은지 확인합니다.
5. 체크아웃 중이라면 먼저 체크아웃 청구 안내를 검토합니다.

결제가 차단된 경우

• 결제 게이트웨이가 연결되어 있고 활성 상태인지 확인합니다.
• 보증금, 객실 결제 또는 체크아웃 결제에 대한 호텔 정책을 확인합니다.
• 면제 후 평가된 결제 대상 잔액이 양수로 남아 있는지 확인합니다.
• 결제 수금이 활성화되어 있을 때 남은 잔액을 체크아웃을 통해 수금합니다.
• 필요하면 관리자에게 Settings → Payment를 검토하도록 요청합니다.
• 결제 통합 유형이 "DISABLE"로 설정되어 있지 않은지 확인합니다.

문제 해결

결제 후 잔액이 업데이트되지 않음

보이는 현상: 폴리오 잔액에 이전 금액이 계속 표시됩니다.

해결:

1. 예약 모달을 다시 엽니다.
2. Folio Details에서 Refresh를 클릭합니다.
3. 캡처 후 10~30초 기다립니다.
4. 잔액이 여전히 변경되지 않으면 페이지를 새로 고칩니다.

Opera 결제와 취소가 0으로 상계되지 않음

보이는 현상: Opera에는 결제와 일치하는 취소가 표시되지만 AVA에는 양수 잔액이 표시됩니다.

해결:

1. 두 항목이 동일한 Opera 폴리오 창에 속하는지 확인합니다.
2. Opera에서 결제와 취소 금액이 동일한 반대 부호인지 확인합니다.
3. Folio Details에서 Refresh를 클릭합니다.
4. Opera Window 1의 잔액과 통화가 AVA와 일치하는지 확인합니다.
5. 새로 고친 후에도 금액이 다르면 지원팀에 문의합니다.

Paid 또는 Pre-auth에 예상과 다른 통화가 표시됨

보이는 현상: 예약 카드의 결제 요약 금액에 다른 통화 코드가 표시됩니다.

해결:

1. 예약을 열고 예약 통화를 확인합니다.
2. 결제 데이터에 자체 통화가 포함되어 있는지 확인합니다.
3. 둘 다 비어 있으면 Settings → Essentials → Hotel Basic Details에서 Property Currency를 검토합니다.
4. 해당 필드가 PMS 관리형이면 PMS에서 통화를 업데이트하고 동기화를 기다립니다.
5. 페이지를 새로 고치고 업데이트된 통화 표시를 확인합니다.

폴리오 세부 정보를 사용할 수 없음

보이는 현상: 폴리오 토글이 비활성화되어 있거나 예약에 스냅샷 잔액이 표시됩니다.

해결:

1. PMS가 폴리오 세부 정보를 지원하는지 확인합니다.
2. 예약 세부 정보 모달에서 Refresh를 클릭합니다.
3. 제공자가 계속 액세스 미지원으로 보고하면 스냅샷 잔액을 사용합니다.
4. 제공자 사유가 잘못된 것 같으면 지원팀에 문의합니다.

폴리오에 보이는 행과 잔액이 일치하지 않음

보이는 현상: AVA에 잔액 불일치 경고가 표시되거나 폴리오 합계가 예상과 다릅니다.

발생 이유: PMS 요금 변경으로 인해 이전 요금에 연결된 조정이 남아 있을 수 있습니다.

해결:

1. Folio Details에서 Adjustments를 펼칩니다.

2. PMS의 현재 객실 요금과 조정을 비교합니다.

3. 조정이 더 이상 유효하지 않으면 PMS에서 삭제합니다.

4. PMS가 업데이트될 때까지 기다린 후 AVA에서 Refresh를 클릭합니다.

5. PMS와 AVA의 합계가 일치할 때까지 결제를 수금하지 마세요.

   ✓ 보이는 섹션에서 표시된 잔액을 설명할 수 있어야 합니다.

Mews 포함 상품 검토 필요

보이는 현상: 일치하는 객실 패키지 면제 후 번들 Mews 상품을 검토해야 합니다.

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

해결:

1. Mews 요금, 포함 상품 및 전체 청구서를 검토합니다.
2. 예약이 구성된 숙박 정책과 일치하는지 확인합니다.
3. Mews의 동기화가 완료된 후 예약을 새로 고칩니다.
4. 검증되지 않은 금액을 수금하지 마세요.
5. 프런트 데스크 직원에게 전체 Mews 청구서를 검토하도록 요청합니다.
6. 금액이 계속 다르면 AVA 지원팀에 문의합니다.

돌아온 후 체크아웃 결제가 확인되지 않음

보이는 현상: 결제 페이지에서 돌아왔지만 체크아웃 잔액이 여전히 열린 상태로 보입니다.

해결:

1. AVA가 결제를 확인할 때까지 몇 초 기다립니다.
2. 단말 또는 호스팅 영수증을 확인합니다.
3. 예약 또는 체크아웃 화면을 새로 고칩니다.
4. 결제가 실패한 경우에만 다시 시도합니다.

소액 체크아웃 잔액이 조정되지 않음

보이는 현상: 결제 후 소액 잔액이 남거나 체크아웃이 차단된 상태로 유지됩니다.

해결:

1. 활성 PMS가 체크아웃 반올림을 지원하는지 확인합니다.
2. Settings → Check-In → Check-In Policy에서 잔액 정책이 활성화되어 있는지 확인합니다.
3. Settings → Payment에서 Enable Rounding Adjustment가 켜져 있는지 확인합니다.
4. Opera를 사용하는 경우 **Transaction Code (Rounding)**에 제공업체 코드가 저장되어 있는지 확인합니다.
5. 예약을 새로 고치고 PMS의 실시간 잔액을 확인합니다.

제공자가 체크아웃 반올림을 지원하지 않으면 PMS 또는 프런트 데스크를 사용하세요.

이전 사전 승인이 여전히 열린 것으로 표시됨

보이는 현상: 게스트가 새 카드로 결제한 후에도 이전 사전 승인이 계속 표시됩니다.

해결:

1. 게이트웨이 취소 콜백이 도착할 때까지 몇 분 기다립니다.
2. 예약 모달을 새로 고칩니다.
3. 이전 사전 승인이 여전히 열려 있으면 지원팀에 문의합니다.

아직도 해결되지 않나요?

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

• ❌ 새로 고친 후에도 폴리오 잔액이 잘못됨
• ❌ 캡처는 완료되었지만 모달이 업데이트되지 않음
• ❌ Source 레이블에 예상하지 못한 텍스트가 계속 표시됨
• ❌ 체크아웃 청구 안내가 계속 반복됨
• ❌ AVA가 체크아웃 결제를 확인하지 않음

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

• 예약 ID 또는 확인 번호
• 결제 시각
• 폴리오 패널 스크린샷

관련 가이드

• 예약 세부 정보 보기
• 예약 세부 정보
• 체크아웃