본문으로 건너뛰기

STB EVA 온보딩 전체 가이드

빠른 설정

싱가포르 정부 규정 보고를 활성화하려면 6단계를 완료하세요. 대부분의 호텔은 15-25분 안에 완료합니다.

이 가이드는 Settings → Government Integration에서 STB E-Visitor Authentication(EVA) 온보딩을 단계별로 완료하는 과정을 안내합니다.

단계작업준비물
1Hotel Code 저장Hotel Licensing Board(HLB) 코드
2STB 양식 제출form.gov.sg 접속 권한
3JWKS 생성 및 제출JWKS 제출 링크
4EVA API Key 입력STB 이메일로 받은 API key
5테스트 트랜잭션 생성 및 STB 통지준비된 테스트 트랜잭션
6STB 확인 대기STB 승인 이메일

시작 전​

다음 조건을 확인하세요.

  • 호텔 국가가 Singapore로 설정되어 있습니다
  • Settings write 권한이 있습니다
  • Hotel Licensing Board(HLB) 코드를 알고 있습니다
  • 외부 STB 양식에 접근할 수 있습니다
Hotel Code를 찾는 방법

HLB 코드를 모른다면 licence1.business.gov.sg/hotelreg/search에서 호텔을 검색하세요.

단계별 온보딩​

1단계: Hotel Code 저장​

Government Integration page showing Step 1 with Hotel Code field

  1. Settings → Government Integration으로 이동합니다

  2. Enable E-Visitor Authentication (EVA) Integration을 켭니다

  3. Hotel Licensing Board에서 받은 Hotel Code를 입력합니다

  4. Save Hotel Code를 클릭합니다

    ✓ "Hotel code saved successfully"가 표시됩니다

저장할 수 없나요?

hotel code를 저장하기 전에 Government Integration이 활성화되어 있는지(토글이 파란색인지) 확인하세요.

2단계: STB EVA 온보딩 양식 제출​

Step 2 showing Open STB Form button and confirmation action

  1. Step 2 섹션에서 Open STB Form을 클릭합니다

  2. form.gov.sg에서 HIS-EVA Hotel Onboarding Application을 작성합니다

  3. Streamliner로 돌아옵니다

  4. I have submitted the form을 클릭합니다

  5. 확인 팝업에서 Yes, I have submitted the form을 클릭합니다

    ✓ Step 2가 완료로 표시됩니다

STB가 요구하는 정보

양식에는 호텔 정보와 API 접근 요구사항이 포함됩니다. 처리에는 보통 3-5영업일이 걸립니다.

3단계: JWKS 생성 및 제출​

JWKS(JSON Web Key Set)는 호텔이 STB 시스템에 인증될 수 있도록 하는 보안 자격 증명입니다.

새 키가 필요한 경우(대부분의 호텔)​

Step 3 showing Generate JWKS and Download buttons

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

    ✓ 타임스탬프와 함께 "JWKS generated successfully"가 표시됩니다

  2. Download JWKS txt를 클릭합니다

  3. 파일을 저장합니다(STB에 업로드해야 합니다)

  4. Submit JWKS Form을 클릭해 STB 제출 포털을 엽니다

  5. 다운로드한 JWKS 파일을 업로드합니다

  6. Streamliner로 돌아옵니다

  7. I have submitted the JWKS를 클릭합니다

  8. 팝업에서 확인합니다

    ✓ Step 3가 완료로 표시됩니다

이미 STB 자격 증명이 있는 경우​

일부 호텔은 JWKS 자격 증명을 STB로부터 직접 받습니다. 이 경우 새 키를 생성하지 말고 Override Keys를 사용하세요.

Advanced options expanded showing Override Keys button

  1. Step 3에서 Advanced options를 펼칩니다

  2. Override Keys를 클릭합니다

  3. 표시되는 모달에 기존 자격 증명을 입력합니다

    • JWKS(JSON 형식)
    • Public Key(PEM 형식)
    • Private Key(PEM 형식)

  4. Save Override Keys를 클릭합니다

    ✓ "EVA keys overridden successfully"가 표시됩니다

  5. I have submitted the JWKS를 클릭해 확인합니다

    ✓ Step 3가 완료로 표시됩니다

키를 안전하게 보관하세요

private key나 JWKS를 이메일이나 채팅으로 공유하지 마세요. 이 자격 증명은 정부 시스템 접근 권한을 제공합니다.

4단계: EVA API Key 입력​

STB가 JWKS 제출을 처리한 뒤 API key를 이메일로 보내줍니다.

  1. 이메일에서 STB가 보낸 "EVA API Key" 메일을 확인합니다

  2. API key를 복사합니다(UUID 형식)

  3. Streamliner Step 4로 돌아갑니다

  4. Enter EVA API Key 입력란에 key를 붙여넣습니다

  5. Save API Key를 클릭합니다

    ✓ 시스템이 key를 자동으로 검증합니다 ✓ "API key saved successfully"가 표시됩니다

검증에는 잠시 시간이 걸립니다

시스템이 STB 엔드포인트에 API key를 테스트합니다. 보통 5-10초 정도 걸리며, 검증 중에는 페이지를 닫지 마세요.

5단계: 테스트 트랜잭션 생성 및 STB 통지​

Step 5 showing test transaction ID and notification options

API key를 저장하면 시스템이 자동으로 테스트 트랜잭션을 생성합니다.

  1. 테스트 트랜잭션이 생성될 때까지 기다립니다

    ✓ STB가 반환한 transaction ID가 표시됩니다

  2. Send Automated Email to STB를 클릭해 STB에 알립니다

    ✓ Step 5가 완료로 표시됩니다

    자동 이메일을 사용할 수 없는 경우 Copy transaction ID를 클릭한 뒤, 해당 거래 정보를 포함해 STB에 직접 이메일을 보내세요.

자동 이메일에 경고가 표시되는 경우

"We sent this test transaction to your email only"가 보이면 STB가 알림을 받지 못한 상태입니다. 해당 이메일을 STB로 수동 전달한 뒤 Streamliner에서 확인을 완료하세요.

호텔에 자동 STB 알림 기능을 활성화하려면 success@vouch-technologies.com으로 문의하세요.

6단계: STB 확인 대기​

Step 6 showing waiting status and confirmation button

STB가 테스트 트랜잭션을 검토한 뒤 연동 성공 여부를 확인합니다.

  1. STB 확인 이메일을 기다립니다(보통 1-2영업일)

  2. Streamliner로 돌아옵니다

  3. Mark STB Confirmation Received를 클릭합니다

    ✓ "STB confirmation recorded. EVA onboarding is complete."가 표시됩니다 ✓ 6단계 모두 완료로 표시됩니다

All steps completed showing successful onboarding

🎉 이제 EVA 연동이 활성화되었습니다! 게스트 체크인 데이터가 STB로 자동 제출됩니다.

연동 관리​

테스트 트랜잭션 다시 생성​

테스트 트랜잭션이 만료되었거나 실패한 경우:

  1. Step 5로 이동합니다
  2. Re-generate Test Transaction을 클릭합니다
  3. 새 transaction ID로 STB에 알립니다

온보딩 초기화​

처음부터 다시 시작해야 하는 경우:

  1. success@vouch-technologies.com으로 문의합니다
  2. EVA 온보딩 초기화를 요청합니다
  3. 새 자격 증명으로 6단계를 모두 다시 진행합니다
초기화하면 기존 자격 증명이 삭제됩니다

초기화 시 모든 JWKS, API key, 진행 상태가 삭제됩니다. 현재 자격 증명을 분실했거나 유출된 경우에만 진행하세요.

문제 해결​

Step 1 버튼이 비활성화됨​

보이는 현상: hotel code를 저장할 수 없습니다.

해결 방법:

  • Enable E-Visitor Authentication (EVA) Integration이 켜져 있는지 확인합니다
  • hotel code 입력란이 비어 있지 않은지 확인합니다
  • 페이지를 새로고침해 봅니다

Step 2를 확인할 수 없음​

보이는 현상: I have submitted the form이 계속 비활성화됩니다.

해결 방법:

  1. 먼저 Step 1을 완료합니다
  2. form.gov.sg에서 STB 양식을 실제로 제출했는지 확인합니다
  3. 돌아와 확인 버튼을 클릭합니다

Override Keys 실패​

보이는 현상: override 자격 증명을 저장할 때 오류가 발생합니다.

해결 방법:

  • JWKS가 유효한 JSON 형식인지 확인합니다
  • public key와 private key가 올바른 헤더(-----BEGIN PUBLIC KEY-----)를 포함한 PEM 형식인지 확인합니다
  • 최소 하나의 필드(JWKS, public key, private key)가 채워져 있는지 확인합니다

API key 검증 실패​

보이는 현상: Save API Key를 클릭한 뒤 오류가 발생합니다.

해결 방법:

  1. key가 완전한지 확인합니다(하이픈 포함 36자)
  2. key 앞뒤의 불필요한 공백을 제거합니다
  3. 선택한 환경에 맞는 TEST 또는 LIVE key를 사용 중인지 확인합니다
  4. Step 3(JWKS)가 완료되었는지 확인합니다