본문으로 건너뛰기

결제 게이트웨이 통합

빠른 설정

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

이 가이드는 Settings → Payment에서 결제와 청구 표시 규칙을 설정하는 방법을 안내합니다. Stripe를 사용하는 경우 연결하기 전에 Live 또는 Test를 먼저 선택하세요. 객실 결제 면제는 예약 메모와 출처 레이블에서 독립 키워드를 확인합니다. Opera의 Booking.com (VCC) 같은 여행사 이름도 같은 면제를 트리거할 수 있습니다. 예전 OTA 출처 선택기는 이제 이 페이지에 없습니다.

위치​

Settings → Payment

빠른 참고​

설정 영역제어 항목주요 결과
Billing View상세 또는 간단한 게스트 청구 요약항목별 행 또는 더 짧은 요약이 표시됨
Payment Gateway IntegrationStripe 또는 Red Dot 설정키오스크 흐름에서 게스트가 결제할 수 있음
Stripe EnvironmentStripe 게이트웨이와 단말 연결의 Live 또는 Test 모드연결 후 잠김
Payment Collection Mode보증금 및 전액 결제 토글체크인 시 게스트가 무엇을 결제할지 제어함
Comment-Based Room Payment Waivers예약 메모의 면제 키워드PMS가 키워드 면제 지원을 제공할 때 잔액 차단을 건너뜀
Property Currency (in Settings → Essentials)보증금과 예약 결제 표시를 위해 해석된 통화설정과 운영 전반에서 결제 금액을 일관되게 유지함
Deposit Currency이 페이지의 보증금 금액에 사용하는 통화다른 결제 설정과 함께 저장됨
Opera Payment Mapping정산, 캐셔, 결제 유형 매핑Opera에 결제 내역이 올바르게 반영됨
Opera Payment Policy Controls반올림, 사전 승인, 숨김, 미수집 로직Opera 전용 결제 동작이 적용됨

시작 전 준비​

  • 결제 게이트웨이 계정을 준비합니다.
  • Detailed 또는 Simplified 청구 보기 중 하나를 선택합니다.
  • 보증금, 전액 결제, 또는 둘 다 사용할지 결정합니다.
  • 보증금 정책과 Settings → Essentials → Hotel Basic Details의 숙소 통화 원본을 확인합니다.
  • 사용 중인 PMS 버전이 결제 면제 키워드를 지원하는지 명확히 확인합니다. AVA가 지원 여부를 확인할 수 없으면 해당 필드는 숨겨집니다.
  • Opera를 사용하는 경우 캐셔 ID와 결제 수단 코드 매핑을 준비합니다.

단계별 설정​

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

  1. Settings → Payment로 이동합니다.
  2. Payment Gateway Integration에서 Stripe 또는 Red Dot Payment를 선택합니다.

Stripe의 경우​

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

운영 환경에서는 Live를, 샌드박스 온보딩에는 Test를 사용합니다. Stripe가 연결되면 연결을 끊을 때까지 환경은 읽기 전용이 됩니다.

단말 Stripe 설정은 연결하기 전에 변경하지 않으면 기본값이 Live입니다.

단말 체크아웃

키오스크에 매핑된 Stripe 단말이 하나만 있으면 체크아웃 중 AVA가 자동으로 엽니다. 둘 이상 매핑된 경우에는 결제 모달의 단말 선택기에서 고릅니다. 단말 모드가 꺼져 있으면 AVA는 게이트웨이 또는 QR 결제 흐름을 유지합니다.

Red Dot Payment의 경우​

  1. Merchant ID를 입력합니다.
  2. Secret Key를 입력합니다.
  3. Environment(TEST 또는 LIVE)를 선택합니다.
  4. Save Payment Gateway Settings를 클릭합니다.

2단계: 청구 보기 선택​

이 카드는 게스트에게 보이는 청구 요약을 제어합니다. 세부 행을 보려면 Detailed를 선택합니다. Room Charges, Tax, 그리고 합계만 보려면 Simplified를 선택합니다.

  1. Settings → Payment로 이동합니다.
  2. Billing View에서 Detailed 또는 Simplified를 선택합니다.
  3. Save를 클릭합니다.
청구 보기 위치

이 카드는 결제 페이지의 Terminal Payment Configuration 앞에 표시됩니다.

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

Toggle동작
Collect Security Deposits체크인 중 보증금을 사전 승인
Collect Full Payment체크인 중 미결제 잔액 전액 결제
  1. 토글을 하나 이상 켭니다.
  2. 둘 다 꺼져 있으면 체크인 시 결제를 요청하지 않습니다.
  3. Save Payment Gateway Settings를 클릭합니다.

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

  1. Deposit Amount를 입력합니다.
  2. Deposit Type(1박당 또는 고정 금액)을 선택합니다.
  3. Deposit Currency가 보이면 호텔에서 보증금에 사용하는 통화를 선택합니다.
  4. Save Payment Gateway Settings를 클릭합니다.
보증금 통화 기준

결제 설정은 Settings → Essentials → Hotel Basic Details의 확인된 Property Currency를 사용합니다. PMS가 통화를 제공하면 AVA는 해당 값을 사용하고 로컬 편집을 잠급니다. 선택한 Deposit Currency는 다른 결제 설정과 함께 저장됩니다.

5단계: Opera 결제 매핑 설정 (Opera 전용)​

  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단계: Opera 결제 정책 제어 설정 (Opera 전용)​

  1. Opera Payment Policy Controls에서 결제 동작을 설정합니다.
    • 인보이스 표시 및 체크아웃 검증
    • 반올림 조정 및 거래 코드
    • 자동 지연 캡처 옵션
    • 숨김 및 미수집 규칙 목록
  2. Save Payment Policies를 클릭합니다.
Opera 결제 메모

Opera 결제 또는 보증금 전기가 성공하면 AVA가 Opera에 예약 메모를 추가합니다. 이 작업은 자동으로 수행되며 Streamliner의 결제 결과는 바꾸지 않습니다. 전역 객실 면제 키워드는 위에서 설정합니다.

저장 후 기대 동작​

  • ✅ 설정 후 연결된 게이트웨이 세부 정보가 표시됩니다.
  • ✅ Stripe는 연결 상태 배지에 Live 또는 Test로 표시됩니다.
  • ✅ 청구 보기 설정은 다른 결제 설정과 함께 저장됩니다.
  • ✅ 보증금을 활성화하면 보증금 필드가 표시됩니다.
  • ✅ Save를 클릭하면 보증금 통화가 계속 저장됩니다.
  • ✅ Opera 매핑과 Opera 정책 섹션은 Opera PMS에서만 표시됩니다.
  • ✅ Step 3: Configure Opera PMS Payment Mapping 카드는 active PMS provider가 Opera일 때 표시됩니다.
  • ✅ 결제 설정은 같은 페이지에서 서로 독립적으로 저장됩니다.
마이그레이션 안내

결제 설정 위치가 Settings → Essentials에서 Settings → Payment로 이동했습니다. 예전 OTA 출처 선택기는 제거되었습니다.

문제 해결​

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

보이는 내용: 결제 토글 또는 저장 버튼이 비활성화됩니다.

해결:

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

청구 보기가 바뀌지 않음​

보이는 내용: 게스트가 여전히 예전 청구 요약 레이아웃을 봅니다.

해결:

  1. Settings → Payment로 돌아갑니다.
  2. Detailed 또는 Simplified를 다시 선택합니다.
  3. Billing View 카드에서 Save를 클릭합니다.
  4. 새 게스트 흐름을 시작하거나 예약 화면을 새로고침합니다.
  5. 여전히 이상하면 호텔이 현재 CCI 설정 경로를 사용하는지 확인합니다.

Stripe 환경이 잠김​

보이는 내용: Stripe가 연결된 뒤 Environment 드롭다운이 비활성화됩니다.

해결:

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

Opera 섹션이 표시되지 않음​

보이는 내용: Opera 매핑과 정책 카드가 보이지 않습니다.

해결:

  1. Settings → Essentials → PMS Integration을 엽니다.
  2. 활성 PMS 제공사가 Opera인지 확인합니다.
  3. Settings → Payment로 돌아갑니다.
  4. 페이지를 한 번 새로고침합니다.
  5. Step 3: Configure Opera PMS Payment Mapping이 표시되는지 확인합니다.

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

보이는 내용: Save를 클릭한 뒤 캐셔 또는 결제 수단 행이 사라집니다.

해결:

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

Opera 예약 메모가 없음​

보이는 내용: 결제는 성공했지만 Opera에 새 예약 메모가 보이지 않습니다.

해결:

  1. Streamliner에서 결제 또는 보증금이 성공적으로 끝났는지 확인합니다.
  2. Opera 예약에 일치하는 결제 기록이 있는지 확인합니다.
  3. 호텔 정책상 허용될 때만 결제를 다시 시도합니다.
  4. 결제는 전기되었는데 메모가 여전히 나타나지 않으면 지원팀에 문의합니다.

Opera 댓글 유형 또는 위치가 잘못 보임​

보이는 내용: Opera가 결제 메모는 만들지만 유형이나 위치가 예상과 다르게 보입니다.

해결:

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

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

보이는 내용: 결제가 와야 할 예약에서 객실 결제가 건너뜁니다.

해결:

  1. PMS에서 해당 예약을 엽니다.
  2. 예약 메모, 출처 이름, Opera 여행사 레이블을 확인합니다.
  3. 예약이 면제 대상이 아니어야 한다면 키워드를 제거하거나 변경합니다.
  4. AVA를 새로고침하고 새 예약으로 다시 테스트합니다.

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

보이는 내용: 면제 키워드 필드가 보이지 않거나, Payment Policy Controls에 지원되지 않는 PMS 메시지가 표시됩니다.

해결:

  1. 사용 중인 PMS가 키워드 면제를 지원하는지 확인합니다.
  2. Settings → Payment를 새로고침합니다.
  3. 그래도 필드가 보이지 않으면 AVA가 아직 해당 PMS에 대한 지원 데이터를 갖고 있지 않은 것입니다.
  4. 기존 면제 키워드는 그대로 두세요. 편집기가 숨겨져 있어도 AVA는 값을 계속 저장합니다.

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

보이는 내용: 객실, 세금, 보증금, 부대비용 행이 AVA에서 다르게 보입니다.

해결:

  1. 해당 예약이 AVA 청구 규칙을 지원하는 PMS에서 온 것인지 확인합니다.
  2. Opera를 사용한다면 다음 예약 동기화를 기다립니다.
  3. Settings → Payment를 새로고침하거나 예약을 다시 엽니다.
  4. PMS 청구서를 확인해 해당 행이 숨김인지 면제인지 확인합니다.

투숙객에게 결제가 요청되지 않음​

보이는 내용: 체크인 중 게스트가 결제 단계를 건너뜁니다.

해결:

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

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

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

해결:

  1. Settings → Essentials → Hotel Basic Details를 엽니다.
  2. Property Currency가 PMS에서 관리되는지 또는 편집 가능한지 확인합니다.
  3. PMS에서 관리되는 경우 PMS에서 통화를 업데이트한 뒤 동기화를 기다립니다.
  4. Settings → Payment를 새로고침하고 통화를 확인합니다.

계속 해결되지 않나요?​

다음에 해당하면 success@vouch-technologies.com으로 문의하세요.

  • ❌ 설정을 다시 저장해도 결제가 계속 실패함
  • ❌ Opera 매핑 값이 유지되지 않음
  • ❌ Stripe 또는 Red Dot 연결이 반복적으로 끊김

함께 전달하면 좋은 정보:

  • Settings → Payment 화면 스크린샷
  • PMS 제공사 이름
  • 예시 예약 ID와 발생 시각