Lewati ke konten utama

Onboarding Lengkap STB EVA

Pengaturan Cepat

Selesaikan 6 langkah untuk mengaktifkan pelaporan kepatuhan pemerintah Singapura. Sebagian besar hotel selesai dalam 15-25 menit.

Panduan ini memandu Anda melalui proses onboarding STB E-Visitor Authentication (EVA) dari Settings → Government Integration.

LangkahTindakanYang Anda Butuhkan
1Simpan Hotel CodeKode Hotel Licensing Board (HLB)
2Kirim Formulir STBAkses ke form.gov.sg
3Buat & Kirim JWKSTautan pengiriman JWKS
4Masukkan EVA API KeyAPI key dari email STB
5Buat & Beri Tahu STBTest transaction siap
6Tunggu Konfirmasi STBEmail persetujuan dari STB

Sebelum Memulai​

Pastikan persyaratan berikut terpenuhi:

  • Negara hotel Anda disetel ke Singapore
  • Anda memiliki izin Settings write
  • Anda memiliki kode Hotel Licensing Board (HLB)
  • Anda dapat mengakses formulir STB eksternal
Di Mana Menemukan Hotel Code

Cari hotel Anda di licence1.business.gov.sg/hotelreg/search jika Anda belum mengetahui kode HLB Anda.

Onboarding Langkah demi Langkah​

Langkah 1: Simpan Hotel Code​

Government Integration page showing Step 1 with Hotel Code field

  1. Buka Settings → Government Integration

  2. Aktifkan Enable E-Visitor Authentication (EVA) Integration

  3. Masukkan Hotel Code Anda dari Hotel Licensing Board

  4. Klik Save Hotel Code

    ✓ Anda akan melihat "Hotel code saved successfully"

Tidak Bisa Menyimpan?

Pastikan Government Integration sudah aktif (toggle berwarna biru) sebelum menyimpan hotel code.

Langkah 2: Kirim Formulir Onboarding STB EVA​

Step 2 showing Open STB Form button and confirmation action

  1. Pada bagian Step 2, klik Open STB Form

  2. Lengkapi formulir HIS-EVA Hotel Onboarding Application di form.gov.sg

  3. Kembali ke Streamliner

  4. Klik I have submitted the form

  5. Pada popup konfirmasi, klik Yes, I have submitted the form

    ✓ Step 2 akan tampil sebagai selesai

Informasi yang Dibutuhkan STB

Formulir ini meminta detail hotel Anda dan kebutuhan akses API. Proses peninjauan biasanya memakan waktu 3-5 hari kerja.

Langkah 3: Buat dan Kirim JWKS​

JWKS (JSON Web Key Set) adalah kredensial keamanan yang mengautentikasi hotel Anda ke sistem STB.

Jika Anda Membutuhkan Kunci Baru (Sebagian Besar Hotel)​

Step 3 showing Generate JWKS and Download buttons

  1. Pada Step 3, klik Generate JWKS

    ✓ Anda akan melihat "JWKS generated successfully" beserta timestamp

  2. Klik Download JWKS txt

  3. Simpan file tersebut (Anda akan mengunggahnya ke STB)

  4. Klik Submit JWKS Form untuk membuka portal pengiriman STB

  5. Unggah file JWKS yang telah Anda unduh

  6. Kembali ke Streamliner

  7. Klik I have submitted the JWKS

  8. Konfirmasi di popup

    ✓ Step 3 akan tampil sebagai selesai

Jika Anda Sudah Memiliki Kredensial STB​

Beberapa hotel menerima kredensial JWKS langsung dari STB. Gunakan Override Keys alih-alih membuat kunci baru:

Advanced options expanded showing Override Keys button

  1. Pada Step 3, buka Advanced options

  2. Klik Override Keys

  3. Pada modal yang muncul, masukkan kredensial Anda yang sudah ada:

    • JWKS (format JSON)
    • Public Key (format PEM)
    • Private Key (format PEM)

  4. Klik Save Override Keys

    ✓ Anda akan melihat "EVA keys overridden successfully"

  5. Klik I have submitted the JWKS untuk mengonfirmasi

    ✓ Step 3 akan tampil sebagai selesai

Jaga Keamanan Kunci Anda

Jangan pernah membagikan private key atau JWKS Anda melalui email atau chat. Kredensial ini memberikan akses ke sistem pemerintah.

Langkah 4: Masukkan EVA API Key​

Setelah STB memproses pengiriman JWKS Anda, mereka akan mengirimkan API key melalui email.

  1. Periksa email Anda untuk pesan "EVA API Key" dari STB

  2. Salin API key tersebut (format UUID)

  3. Kembali ke Streamliner Step 4

  4. Tempel key ke kolom Enter EVA API Key

  5. Klik Save API Key

    ✓ Sistem akan memvalidasi key secara otomatis ✓ Anda akan melihat "API key saved successfully"

Validasi Membutuhkan Beberapa Saat

Sistem akan menguji API key Anda ke endpoint STB. Proses ini memakan waktu 5-10 detik. Jangan tutup halaman selama validasi berlangsung.

Langkah 5: Buat Test Transaction dan Beri Tahu STB​

Step 5 showing test transaction ID and notification options

Setelah API key tersimpan, sistem akan otomatis membuat test transaction.

  1. Tunggu hingga test transaction dibuat

    ✓ Anda akan melihat transaction ID yang dikembalikan oleh STB

  2. Klik Send Automated Email to STB untuk memberi tahu STB

    ✓ Step 5 akan tampil sebagai selesai

    Jika email otomatis tidak tersedia, klik Copy transaction ID lalu kirim email ke STB secara manual dengan detail transaksi tersebut.

Jika Email Otomatis Menampilkan Peringatan

Jika Anda melihat "We sent this test transaction to your email only", berarti STB belum menerima notifikasi tersebut. Teruskan email itu ke STB secara manual, lalu konfirmasi di Streamliner.

Hubungi success@vouch-technologies.com jika Anda ingin notifikasi otomatis ke STB diaktifkan untuk properti Anda.

Langkah 6: Tunggu Konfirmasi STB​

Step 6 showing waiting status and confirmation button

STB akan meninjau test transaction Anda dan mengonfirmasi bahwa integrasi berhasil.

  1. Tunggu email konfirmasi dari STB (biasanya 1-2 hari kerja)

  2. Kembali ke Streamliner

  3. Klik Mark STB Confirmation Received

    ✓ Anda akan melihat "STB confirmation recorded. EVA onboarding is complete." ✓ Semua 6 langkah akan tampil sebagai selesai

All steps completed showing successful onboarding

🎉 Integrasi EVA Anda sekarang aktif! Data check-in tamu akan otomatis dikirim ke STB.

Mengelola Integrasi Anda​

Buat Ulang Test Transaction​

Jika test transaction Anda kedaluwarsa atau gagal:

  1. Buka Step 5
  2. Klik Re-generate Test Transaction
  3. Beri tahu STB menggunakan transaction ID yang baru

Reset Onboarding​

Jika Anda perlu memulai ulang:

  1. Hubungi success@vouch-technologies.com
  2. Minta reset onboarding EVA
  3. Ulangi semua 6 langkah dengan kredensial baru
Reset Akan Menghapus Kredensial yang Ada

Reset akan menghapus semua JWKS, API key, dan progres yang sudah tersimpan. Lakukan ini hanya jika kredensial Anda saat ini hilang atau terkompromi.

Pemecahan Masalah​

Tombol Step 1 dinonaktifkan​

Yang Anda lihat: Tidak dapat menyimpan hotel code.

Perbaikan:

  • Pastikan Enable E-Visitor Authentication (EVA) Integration sudah aktif
  • Pastikan kolom hotel code tidak kosong
  • Coba muat ulang halaman

Step 2 tidak bisa dikonfirmasi​

Yang Anda lihat: I have submitted the form tetap dinonaktifkan.

Perbaikan:

  1. Selesaikan Step 1 terlebih dahulu
  2. Pastikan Anda benar-benar mengirim formulir STB di form.gov.sg
  3. Kembali dan klik tombol konfirmasi

Override Keys gagal​

Yang Anda lihat: Terjadi galat saat menyimpan kredensial override.

Perbaikan:

  • Pastikan JWKS berformat JSON yang valid
  • Pastikan public key dan private key menggunakan format PEM dengan header yang benar (-----BEGIN PUBLIC KEY-----)
  • Pastikan minimal satu kolom terisi (JWKS, public key, atau private key)

Validasi API key gagal​

Yang Anda lihat: Galat setelah mengklik Save API Key.

Perbaikan:

  1. Pastikan key lengkap (36 karakter termasuk tanda hubung)
  2. Hapus spasi tambahan di awal atau akhir key
  3. Pastikan Anda menggunakan key TEST atau LIVE yang sesuai dengan environment yang dipilih
  4. Pastikan Step 3 (JWKS) sudah selesai