STB EVA 정부 연동 설정

빠른 설정

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

이 안내서는 Government Compliance에서 싱가포르 STB EVA 온보딩을 완료하는 방법을 설명합니다.

EVA를 건너뛰는 경우

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

얼굴 검증 후

얼굴 검증 후 EVA 제출이 실패해도 AVA는 오류를 기록하고 게스트 흐름을 계속 진행합니다. 체크인을 완료한 후 나중에 로그를 검토할 수 있습니다.

설정	제어 항목	결과
Government Integration	EVA 온보딩 도구를 활성화합니다	STB 온보딩을 시작할 수 있습니다
EVA Environment	샌드박스(TEST) 또는 프로덕션(LIVE) 트래픽을 선택합니다	즉시 저장되며, LIVE에는 확인이 필요합니다
Hotel Code	EVA 요청에 사용되는 호텔 식별자입니다	저장 후 2단계가 잠금 해제됩니다
JWKS	EVA 서명 키와 3단계 확인을 관리합니다	제출을 확인하면 4단계가 잠금 해제됩니다
EVA API Key	EVA 거래 호출에 사용하는 자격 증명입니다	유효하게 저장하면 테스트 거래를 실행할 수 있습니다
EVA skip rule	불필요한 EVA 제출을 방지합니다	싱가포르 관련 게스트는 EVA 호출 없이 계속 진행합니다
Generate New JWKS	기존 온보딩 자격 증명을 교체합니다	3~6단계를 다시 수행해야 합니다

시작하기 전에

• 호텔 국가가 Singapore입니다.
• Settings read 권한과 저장에 필요한 settings-write 액세스 권한이 있습니다.
• STB 호텔 코드를 알고 있습니다.
• STB 양식과 JWKS 제출 링크에 액세스할 수 있습니다.

settings:write가 없는 사용자는 설정을 볼 수 있지만 변경할 수 없습니다.

STB EVA 설정 찾기

1. Government Compliance를 엽니다.
2. Singapore → STB EVA를 엽니다.
3. Start STB EVA setup, Continue setup 또는 Resolve setup을 선택합니다.

전송 상태를 확인하려면 Command Center → Analytics를 사용하세요. 온보딩이 완료되지 않은 경우 Analytics에 STB EVA setup required가 표시됩니다.

기존 링크

이전 Settings → Government Integration 링크도 STB EVA 설정으로 리디렉션됩니다.

단계별 설정

1. Government Compliance → Singapore → STB EVA를 엽니다.

2. Government Integration을 켭니다.

3. EVA Environment에서 TEST 또는 LIVE를 선택합니다.

   • 서버 승인을 받은 STB 샌드박스 가맹점에만 TEST를 선택하세요.
   • STB가 프로덕션 자격 증명을 승인한 후에만 LIVE를 선택하세요.
   • 저장된 값이 없거나 지원되지 않는 경우 Streamliner는 TEST를 표시합니다.

   ✓ 유효한 선택을 하면 환경이 즉시 저장됩니다.

4. LIVE를 선택했다면 경고를 검토하고 Switch to LIVE를 클릭합니다. 현재 환경을 유지하려면 Cancel을 선택합니다.

   ✓ 환경을 변경해도 호텔 코드나 EVA 자격 증명은 교체되지 않습니다.

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

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

6. Step 2에서 View guide for FormSG questions 1–15를 클릭합니다.

7. 공식 STB FormSG 신청서를 작성하는 동안 안내서를 열어 둡니다.

8. 안내서를 닫은 다음 Open STB Form을 클릭합니다.

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

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

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

11. Step 3에서 Generate JWKS를 클릭합니다.
12. Download JWKS txt를 클릭합니다.
13. Submit JWKS Form을 클릭하고 STB JWKS 제출을 완료합니다.
14. Streamliner로 돌아와 I have submitted the JWKS를 클릭합니다.
15. 확인 팝업에서 Yes, I have submitted the JWKS를 클릭합니다.

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

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

ℹ️ 키를 저장한 적이 있으면 입력란을 클릭할 때까지 마스킹된 별표가 표시됩니다.

17. 자동 검증이 완료될 때까지 기다립니다.

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

18. Step 5에서 거래 ID를 복사합니다. 필요한 경우 Re-generate Test Transaction을 클릭합니다.
19. Step 5에서 Send Automated Email to STB를 클릭합니다.
20. STB의 연결 확인 이메일을 기다립니다.
21. Step 6에서 Mark STB Confirmation Received를 클릭합니다.

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

FormSG 신청서 작성

공식 FormSG 신청서 옆에서 제품 내 안내서를 사용하세요. Vouch가 신청서를 대신 제출하지는 않습니다. 제출하기 전에 승인된 호텔 담당자와 법적 세부 정보를 확인하세요.

FormSG 질문	입력 또는 선택할 내용
1. Requested API Services	**E-Visitor Authentication (for Hotel Applicants)**를 선택합니다.
2. Justifications	아래의 복사 가능한 문구를 입력합니다. 자동 체크인과 게스트 동의에 대해 설명하는 내용입니다.
3. Country of Incorporation	호텔 위치가 아니라 신청 조직의 법인 설립 국가를 입력합니다.
4. Organisation Name	정확한 법적 명칭을 입력합니다. 싱가포르 법인은 Corppass 기록과 일치해야 합니다.
5. Hotel Name and Hotel Code	숙소 이름과 HLB 호텔 코드를 입력합니다. 호텔 파트너가 없는 벤더 신청자는 N.A.를 입력합니다.
6. Email Address for Test Environment	모니터링되는 운영 이메일을 사용합니다. STB가 프로덕션 알림에 이 주소를 사용합니다.
7. Reason for APEX JWT Request	다음을 입력합니다: Contactless check-in integration, implemented via appointed technology vendor Vouch Technologies on the hotel's behalf.
8. Nature of Business	아래의 복사 가능한 문구를 입력합니다. 가능한 경우 공식 웹사이트도 포함합니다.
9–13. Contact details	요청자의 호칭, 법적 이름, 직함 및 업종을 입력합니다. 일반적으로 Hospitality 또는 ICT가 적합합니다.
14. Applicant type	Hotel Applicant을 선택합니다. 호텔이 EVA 자격 증명을 소유합니다.
15. Technology provider	Vouch Technologies를 입력합니다. STB가 다른 형식을 요청하면 법적 명칭을 사용합니다.

복사 가능한 FormSG 문구

Question 2에는 다음을 입력합니다: EVA will be used for authorised, automated hotel check-in, and the hotel will obtain guest consent before any data is submitted.

Question 8에는 다음을 입력합니다: The Hotel provides accommodation and hospitality services to its guests. It has engaged technology vendor Vouch Technologies to implement a contactless check-in solution on its behalf, using EVA to support guest authentication during check-in.

신청자 정보 확인

호텔이 EVA 자격 증명을 신청하고 소유합니다. Vouch Technologies는 지정된 기술 제공자로서 연동을 지원합니다. 공식 양식을 제출하기 전에 모든 법적 세부 정보를 확인하세요.

양식 제출 후

1. STB가 요청을 검토하는 데 최대 영업일 기준 7일이 걸릴 수 있습니다.
2. 테스트 키를 받은 후 달력일 기준 14일 이내에 연결 테스트를 완료합니다.
3. 프로덕션 자격 증명을 요청하기 전에 성공적인 테스트 증거를 STB와 공유합니다.

샌드박스 테스트 액세스를 안전하게 사용하기

서버 승인을 받은 샌드박스 가맹점에만 Test access가 표시됩니다. 샌드박스 테스트 거래는 STB TEST를 사용합니다. 실제 STB에 연락하거나 실제 확인을 기록할 수 없습니다.

1. Government Compliance → Singapore → STB EVA를 엽니다.
2. 표시되면 Test access를 클릭합니다.
3. 페이지에 샌드박스 액세스가 승인되었다고 표시되는지 확인합니다.
4. STB EVA setup으로 돌아와 승인된 TEST 흐름을 완료합니다.

샌드박스 가맹점을 LIVE로 전환하지 마세요.

LIVE에는 프로덕션 승인이 필요합니다

STB가 프로덕션 액세스를 승인하고 프로덕션 자격 증명을 제공한 후에만 LIVE로 전환하세요. 확인 대화 상자는 실수로 프로덕션 트래픽을 보내는 것을 방지하는 데 도움이 됩니다.

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

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

이메일을 STB로 전달한 다음 STB 확인을 기다리고 6단계를 완료하세요.

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

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

문제 해결

싱가포르 관련 게스트에서 EVA가 건너뛰어집니다

보이는 현상: 게스트가 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. 다시 실패하면 지원팀에 문의합니다.

EVA 환경을 변경할 수 없습니다

보이는 현상: Streamliner가 TEST 또는 LIVE 선택을 거부합니다.

해결 방법:

1. 샌드박스 가맹점은 TEST를 유지해야 합니다.
2. 샌드박스 승인이 없으면 샌드박스가 아닌 가맹점은 TEST로 전환할 수 없습니다.
3. settings:write 권한이 있는지 확인합니다.
4. 정책이 호텔에 적용되는 내용과 일치하지 않으면 Vouch Support에 문의합니다.

EVA 환경 변경 사항을 저장하지 못합니다

보이는 현상: 선택 후 선택기가 이전 값으로 돌아갑니다.

해결 방법:

1. 성공 또는 오류 메시지가 표시될 때까지 기다립니다.
2. 선택을 한 번 다시 시도합니다.
3. 호텔 컨텍스트가 올바른지 확인합니다.
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 Compliance → Singapore → STB EVA를 엽니다.

아직 문제가 해결되지 않았나요?

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

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

포함하면 유용한 정보:

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

관련 안내

• 호텔 기본 정보 설정
• PMS 연결
• 호텔 전환 후 설정이 저장되지 않음