예약 결제 관리
예약 모달의 Payments를 사용하세요. 대부분의 확인 작업은 3분 이내에 끝납니다.
이 가이드는 잔액을 검토하고, 결제를 캡처하고, 폴리오 세부 정보를 읽는 방법을 안내합니다.
| 항목 | 표시 내용 | 사용 위치 |
|---|---|---|
| Payment Summary | 결제 완료 금액, 사전 승인, 거래 ID | 예약 카드 |
| Folio Details | 미결제 잔액, 청구 내역, 보증금, 결제 내역 | 예약 모달 |
| Capture Payment | 승인된 결제 캡처 | 예약 모달 |
| Source | 폴리오 항목의 출처 | 폴리오 패널 |
결제 수금 작동 방식
- 결제 규칙은 Settings → Payment에서 가져옵니다.
- 숙소 통화는 Settings → Essentials → Hotel Basic Details에서 가져옵니다.
- 숙소는 보증금, 객실 결제, 체크아웃 결제 또는 세 가지 모두를 수금할 수 있습니다.
- 잔액이 남아 있으면 AVA가 체크아웃 중에 결제 안내를 표시할 수 있습니다.
- 결제 수금이 꺼져 있으면 체크인에서 결제를 건너뜁니다.
- 백엔드 포털은 결제 게이트웨이의 결제 데이터를 표시합니다.
- 체크아웃 청구가 면제되었지만 양수 잔액이 남아 있으면 AVA는 체크아웃 결제를 만들지 않습니다.
- 게스트를 프런트 데스크로 보내 검토하도록 합니다.
결제 정보 보기
예약 카드의 결제 요약
카드 보기에서 예약을 보면 각 카드에 다음이 표시됩니다.
- Paid: 예약에 대해 이미 결제된 총액
- Pre-auth: 해당되는 경우의 사전 승인 금액
- Transaction ID: 결제 게이트웨이 참조 번호와 복사 버튼
결제 데이터가 있으면 이 요약이 자동으로 표시됩니다.
AVA는 먼저 예약 표시 통화로 Paid와 Pre-auth를 보여 줍니다. 그 통화가 없으면 결제 요약 통화를 사용합니다. 둘 다 없으면 숙소 통화로 대체합니다.
Command Center의 결제 단계
결제 통합이 활성화되면 Command Center는 체크인과 체크아웃 흐름에 결제 단계를 표시합니다.
- Check-In Payment Stage: 체크인 진행의 배지
- Checkout Payment Stage: 체크아웃 진행의 배지
- 배지는 대기 중 또는 완료 같은 상태를 보여 줍니다
결제 단계는 결제 통합이 활성화되어 있을 때만 나타납니다. 이 값이 "DISABLE"이면 체크인과 체크아웃에서 결제 단계가 건너뛰어집니다.
예약 모달의 상세 결제 정보
예약을 클릭하면 예약 상세 모달이 열립니다. 이 보기는 다음에서 열 수 있습니다.
- Check-Ins page: 예약 카드 또는 표 행 클릭
- Checkouts page: 체크아웃 카드 클릭
- Stayovers page: 스테이오버 카드 클릭
- Calendar view: 예약 블록 클릭
- Command Center page: 예약 클릭
Financials에서 다음을 검토합니다.
- Balance Due: 현재 미결제 잔액
- Deposit Payment: 수금된 보증금 세부 정보
- Room Payment: 객실 요금 세부 정보
폴리오 접근이 가능하면 Balance Due는 PMS 폴리오 요약에서 가져옵니다. PMS가 AVA인 경우 Streamliner는 보증금과 객실 결제도 폴리오 원장에 동기화합니다. 동기화는 결제 요약, 청구 화면, 캡처 흐름에서 이루어집니다.
Folio Details를 펼치면 다음을 확인할 수 있습니다.
- Room Charges
- Extras
- Taxes
- Deposits
- Payments
청구 요약에서는 Deposits와 Payments가 음수로 표시됩니다. 이것은 표시용일 뿐이므로 Balance Due는 바뀌지 않습니다.
폴리오 패널에는 Fidelity 배지, Last synced, Source 필드도 표시됩니다. Source 레이블은 원시 백엔드 토큰이 아니라 번역된 레이블로 표시됩니다. AVA ledger, Invoice-backed, 또는 지역화된 레이블이 보일 수 있습니다. PMS가 폴리오 세부 정보를 지원하지 않으면 AVA는 스냅샷 잔액을 유지하고 제공자 사유를 표시합니다.
각 결제 기록에는 다음이 표시됩니다.
- "Authorized" 또는 "Captured" 같은 결제 상태
- 결제 금액과 통화
- 신용카드나 현금 같은 결제 수단
- 결제 게이트웨이 이름
- 게이트웨이 참조 번호 또는 거래 ID
- 브랜드와 마지막 4자리 같은 카드 정보
결제 유형
AVA 백엔드 포털은 세 가지 유형의 결제를 추적합니다.
- Deposit Payment: 체크인 전 또는 체크인 중에 수금하는 선결제
- Room Payment: 객실 요금과 추가 서비스에 대한 결제
- Checkout Payment: 체크아웃 중 수금하는 최종 정산
체크아웃 결제 검토
AVA가 체크아웃 결제를 열면 다음 안내 중 하나가 표시될 수 있습니다.
| Prompt | 의미 | 할 일 |
|---|---|---|
| Existing balance | AVA가 보류 중이거나 열린 잔액을 찾음 | 금액을 확인하고 계속 진행 |
| Different card | 게스트가 다른 카드를 원함 | 새 결제 흐름 시작 |
| Dispute | 게스트가 요금에 이의를 제기함 | 호텔의 분쟁 처리 절차를 따름 |
결제 페이지가 AVA로 돌아가면 확인 메시지를 기다리세요. 체크아웃 화면은 완료되기 전에 새로고침될 수 있습니다.
단말 결제 재시도
단말 결제가 이미 완료되었다면, AVA는 재시도 시 즉시 결제 완료 상태를 표시합니다. 이렇게 하면 같은 활성 결제에 대해 두 번 청구되는 일을 막을 수 있습니다.
결제가 취소되었거나 결제 컨텍스트가 바뀌었다면, AVA는 새 단말 흐름을 시작할 수 있습니다.
PMS 단말 사전 승인
숙소에서 PMS 단말 결제를 사용하는 경우, AVA는 요청을 PMS 단말 흐름으로 보냅니다.
- AVA는 요청을 보내기 전에 결제 금액을 로컬에서 먼저 계산합니다.
- 예전
OPI단말 설정도 계속 PMS Terminal로 동작합니다. - 이 흐름은 예약 사전 승인과 체크인 결제 단계에 사용합니다.
- 체크아웃은 여전히 매핑된 Stripe 단말 또는 게이트웨이 흐름을 사용합니다.
결제 캡처
결제 게이트웨이가 지원하면 모달에서 승인된 결제를 캡처할 수 있습니다.
- 예약 상세 모달을 엽니다.
- Financials로 스크롤합니다.
- 결제가 승인되었지만 아직 캡처되지 않았다면 Capture Payment를 클릭합니다.
- 캡처 작업을 확인합니다.
- 결과가 갱신될 때까지 기다립니다.
캡처는 아직 완료되지 않은 승인 결제에만 사용할 수 있습니다.
결제 캡처 결과
결제를 캡처한 뒤 포털은 다음을 표시합니다.
- Payment captured: 예 또는 아니오
- Capture message: 게이트웨이에서 반환한 세부 정보 또는 오류 텍스트
결과가 즉시 보이지 않으면 포털이 최대 60초 동안 조회를 반복합니다.
결제 수금 전에
- PMS 또는 게스트 폴리오에서 예약 잔액을 확인합니다.
- 이 예약에 필요한 결제 수단을 확인합니다.
- Settings → Payment에서 결제 게이트웨이가 연결되어 있는지 확인합니다.
- 결제 통합이 활성화되어 있고 "DISABLE"로 설정되어 있지 않은지 확인합니다.
- 체크아웃 중이라면 먼저 체크아웃 결제 안내를 검토합니다.
결제가 차단될 때
- 결제 게이트웨이가 연결되어 있고 활성 상태인지 확인합니다.
- 보증금, 객실 결제, 체크아웃 결제에 대한 호텔 정책을 확인합니다.
- 체크아웃 청구가 면제되었지만 양수 잔액이 남아 있는지 확인합니다.
- 면제된 양수 잔액은 프런트 데스크에서 처리합니다.
- 필요하면 관리자가 Settings → Payment를 검토하도록 합니다.
- 결제 통합 유형이 "DISABLE"로 설정되어 있지 않은지 확인합니다.
문제 해결
결제 후 잔액이 갱신되지 않음
보이는 현상: 폴리오 잔액이 이전 금액으로 계속 표시됩니다.
해결:
- 예약 모달을 다시 엽니다.
- Folio Details에서 Refresh를 클릭합니다.
- 캡처 후 10~30초 기다립니다.
- 잔액이 여전히 바뀌지 않으면 페이지를 새로고침합니다.
Paid 또는 Pre-auth 통화가 예상과 다름
보이는 현상: 예약 카드의 결제 요약 금액에 다른 통화 코드가 표시됩니다.
해결:
- 예약을 열고 예약 통화를 확인합니다.
- 결제 데이터에 자체 통화가 포함되어 있는지 확인합니다.
- 둘 다 비어 있으면 Settings → Payment에서 Property Currency를 확인합니다.
- 필드가 PMS 관리형이면 PMS에서 통화를 업데이트하고 동기화를 기다립니다.
- 페이지를 새로고침하고 업데이트된 통화 표시를 확인합니다.
폴리오 세부 정보를 사용할 수 없음
보이는 현상: 폴리오 토글이 비활성화되어 있거나 예약에 스냅샷 잔액이 표시됩니다.
해결:
- PMS가 폴리오 세부 정보를 지원하는지 확인합니다.
- 예약 상세 모달에서 Refresh를 클릭합니다.
- 제공자가 여전히 지원하지 않는다고 보고하면 스냅샷 잔액을 계속 사용합니다.
- 제공자 사유가 잘못된 것 같으면 지원팀에 문의합니다.
돌아온 뒤 체크아웃 결제가 확인되지 않음
보이는 현상: 결제 페이지는 돌아왔지만 체크아웃 잔액은 여전히 열린 것처럼 보입니다.
해결:
- AVA가 결제를 확인할 때까지 몇 초 기다립니다.
- 단말 또는 호스팅 영수증을 확인합니다.
- 예약 또는 체크아웃 화면을 새로고침합니다.
- 결제가 실패한 경우에만 다시 시도합니다.
아직도 해결되지 않나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 새로고침 후에도 폴리오 잔액이 잘못됨
- ❌ 캡처는 끝났지만 모달이 갱신되지 않음
- ❌ Source 레이블에 예상하지 못한 텍스트가 계속 표시됨
- ❌ 체크아웃 결제 안내가 계속 반복됨
- ❌ AVA가 체크아웃 결제를 확인하지 않음
함께 전달하면 좋은 정보:
- 예약 ID 또는 확인 번호
- 결제 시각
- 폴리오 패널 스크린샷