본문으로 건너뛰기

STB EVA 정부 연동 설정

빠른 설정

Government Integration를 켜고, TEST/LIVE를 선택한 뒤 6개 온보딩 단계를 순서대로 완료하세요. 대부분의 호텔은 10~20분이면 끝납니다.

이 안내서는 Settings → Check-in에서 싱가포르 STB EVA 온보딩을 완료하는 방법을 설명합니다.

EVA가 건너뛰는 경우

게스트 국적이나 문서 발급 국가가 싱가포르로 판정되면 AVA는 EVA를 건너뜁니다. 두 값이 모두 싱가포르가 아니면 AVA는 게스트를 EVA로 보냅니다.

얼굴 검증 후

얼굴 검증 후 EVA 제출이 실패해도 AVA는 오류를 기록하고 게스트 흐름은 계속 진행합니다. 체크인을 끝낸 뒤 로그를 확인할 수 있습니다.

설정제어 항목결과
Government IntegrationEVA 온보딩 도구 사용STB 온보딩을 시작할 수 있습니다
EVA Environment대상 EVA 엔드포인트 (TEST 또는 LIVE)API 키와 테스트 거래를 실행할 수 있습니다
Hotel CodeEVA 요청에 사용되는 호텔 식별자저장 후 2단계가 열립니다
JWKSEVA 서명 키와 3단계 확인제출을 확인하면 4단계가 열립니다
EVA API KeyEVA 거래 호출용 자격 증명유효하게 저장하면 테스트 거래를 실행할 수 있습니다
EVA skip rule불필요한 EVA 제출 방지싱가포르 관련 게스트는 EVA 호출 없이 계속 진행됩니다
Generate New JWKS기존 온보딩 자격 증명 교체3~6단계를 다시 수행해야 합니다

시작하기 전에​

  • 호텔 국가가 Singapore입니다.
  • Settings write 권한이 있습니다.
  • STB 호텔 코드를 알고 있습니다.
  • STB 양식과 JWKS 제출 링크에 접근할 수 있습니다.

단계별 설정​

  1. Settings → Check-in → Government Integration을 엽니다.

  2. Government Integration를 켭니다.

  3. Environment에서 TEST 또는 LIVE를 선택한 다음 Save EVA Environment를 클릭합니다.

  4. 호텔 코드를 입력하고 Save Hotel Code를 클릭합니다.

    ✓ 이제 2단계를 시작할 수 있습니다.

  5. Step 2에서 Open STB Form을 클릭합니다.

  6. STB 온보딩 양식을 제출합니다.

  7. Streamliner로 돌아와 I have submitted the form을 클릭합니다.

    ✓ 2단계 상태가 Completed로 바뀝니다.

  8. Step 3에서 Generate JWKS를 클릭합니다.

  9. Download JWKS txt를 클릭합니다.

  10. Submit JWKS Form을 클릭하고 STB JWKS 제출을 완료합니다.

  11. Streamliner로 돌아와 I have submitted the JWKS를 클릭합니다.

  12. 확인 팝업에서 Yes, I have submitted the JWKS를 클릭합니다.

✓ 3단계 상태가 Completed로 바뀝니다.

  1. Step 4에서 STB가 발급한 API 키를 입력하고 Save API Key를 클릭합니다.

ℹ️ 이전에 키를 저장한 적이 있으면, 입력란에 포커스를 둘 때까지 값이 마스킹된 별표로 보입니다.

  1. 자동 검증이 끝날 때까지 기다립니다.

✓ 성공하면 Streamliner가 키를 저장하고 테스트 거래를 시작합니다.

  1. Step 5에서 거래 ID를 복사합니다. 필요하면 Re-generate Test Transaction을 클릭합니다.
  2. Step 5에서 Send Automated Email to STB를 클릭합니다.
  3. STB의 연결 확인 이메일을 기다립니다.
  4. Step 6에서 Mark STB Confirmation Received를 클릭합니다.

✓ 6단계 상태가 Completed로 바뀝니다.

자동 전송이 본인에게만 메일을 보낸 경우

"We sent this test transaction to your email only" 같은 ⚠️ 경고가 보이면, Streamliner가 STB에 메일을 보내지 않은 것입니다.

이메일을 STB로 전달한 뒤, STB 확인을 기다렸다가 6단계를 완료하세요.

새 JWKS를 생성하면 기존 자격 증명이 교체됩니다

이미 키가 있으면 새 JWKS를 생성할 때 기존 키가 교체되고 하위 온보딩 진행 상황이 초기화됩니다. API 키 저장, 테스트 거래, STB 확인을 포함해 3~6단계를 다시 수행해야 합니다.

문제 해결​

보이는 현상: 게스트가 EVA 제출 없이 체크인을 완료합니다.

해결:

  1. 게스트 국적과 문서 발급 국가를 확인합니다.
  2. 둘 중 하나라도 싱가포르로 판정되면, EVA가 건너뛰어진 것은 정상 동작으로 처리합니다.
  3. 게스트를 다시 EVA로 보내지 말고 체크인 흐름을 계속합니다.

2단계 버튼이 비활성화됩니다​

보이는 현상: 양식 제출을 확인할 수 없습니다.

해결:

  1. Hotel Code에 값을 저장합니다.
  2. Government Integration가 켜져 있는지 확인합니다.
  3. 다시 시도합니다.

3단계를 확인할 수 없습니다​

보이는 현상: I have submitted the JWKS가 계속 비활성화되어 있습니다.

해결:

  1. 먼저 JWKS를 생성하거나 덮어씁니다.
  2. STB 양식에서 JWKS를 제출합니다.
  3. 돌아와 확인 버튼을 클릭합니다.
  4. 확인 팝업을 완료합니다.

API 키 저장이 3단계 메시지로 차단됩니다​

보이는 현상: EVA API 키를 저장하기 전에 3단계를 완료하라는 오류가 표시됩니다.

해결:

  1. Step 3로 돌아갑니다.
  2. I have submitted the JWKS를 클릭합니다.
  3. 팝업을 확인합니다.
  4. Step 4에서 Save API Key를 다시 시도합니다.

API 키 저장에 실패합니다​

보이는 현상: API 키 형식이 올바르지 않다는 오류가 표시됩니다.

해결:

  1. 키가 전체 UUID 형식인지 확인합니다.
  2. 불필요한 공백을 제거합니다.
  3. 다시 저장합니다.

API 키 입력란에 별표만 보입니다​

보이는 현상: 4단계에 ********-****-****-****-************가 표시됩니다.

해결:

  1. API 키 입력란 내부를 클릭합니다.
  2. 새 키 값을 붙여넣습니다.
  3. Save API Key를 클릭합니다.

테스트 거래가 실패합니다​

보이는 현상: 5단계에 오류 메시지가 표시됩니다.

해결:

  1. EVA Environment가 저장되어 있는지 확인합니다.
  2. 3단계와 4단계가 완료되었는지 확인합니다.
  3. Re-generate Test Transaction을 클릭합니다.
  4. 다시 실패하면 지원팀에 문의합니다.

STB가 B18 또는 C18을 반환합니다​

보이는 현상: STB가 B18, C18, 또는 둘 다로 제출을 거부합니다.

해결:

  1. MRZ가 흐리거나 잘렸거나 가려졌는지 확인합니다.
  2. 그렇다면 전체 MRZ가 보이도록 여행 서류를 다시 스캔합니다.
  3. 게스트 정보가 여권과 정확히 일치하는지 확인합니다.
  4. 제출을 다시 시도합니다.
  5. 계속 실패하면 거래 ID와 함께 지원팀에 문의합니다.
보통 이 방법이 효과적인 이유

AVA는 이제 STB로 전송될 깨끗한 MRZ 데이터를 우선 사용합니다. OCR 품질이 낮거나 문서 정보가 맞지 않으면 여전히 C18이 발생할 수 있습니다.

자동 전송 시 본인에게만 메일을 보냈다는 경고가 표시됩니다​

보이는 현상: Send Automated Email to STB를 클릭한 뒤 ⚠️ 경고로 "We sent this test transaction to your email only"가 표시됩니다.

해결:

  1. 받은편지함에서 거래 이메일을 확인합니다.
  2. 이메일을 STB로 전달합니다.
  3. STB 확인을 기다린 뒤 Step 6을 완료합니다.
  4. 숙소에 대해 STB 자동 이메일을 활성화하고 싶다면 지원팀에 문의합니다.

SG 경고와 함께 온보딩이 숨겨집니다​

보이는 현상: EVA 온보딩은 싱가포르에서만 사용할 수 있다는 메시지가 표시됩니다.

해결:

  1. Settings → Essentials → Hotel Basic Details로 이동합니다.
  2. Country가 Singapore인지 확인합니다.
  3. 새로고친 뒤 Government Integration을 다시 엽니다.

아직 막혔나요?​

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

  • ❌ 저장 후 단계 상태가 업데이트되지 않음
  • ❌ 여러 번 다시 시도해도 STB 확인이 실패함
  • ❌ 자동 전송이 반복적으로 실패함

포함하면 좋은 정보:

  • Government Integration 페이지 스크린샷
  • 정확한 오류 메시지
  • 문제가 시작된 시각