Menyiapkan Integrasi Pemerintah STB EVA

Penyiapan Cepat

Aktifkan Government Integration, pilih TEST/LIVE, lalu selesaikan 6 langkah onboarding secara berurutan. Sebagian besar hotel menyelesaikannya dalam 10-20 menit.

Panduan ini membantu Anda menyelesaikan onboarding STB EVA Singapura dari Government Compliance.

Saat EVA dilewati

AVA melewati EVA ketika kewarganegaraan tamu atau negara penerbit dokumen terdeteksi sebagai Singapura. Jika kedua nilai bukan Singapura, AVA mengirim tamu ke EVA.

Setelah verifikasi wajah

Jika pengiriman EVA gagal setelah verifikasi wajah, AVA mencatat kesalahan dan menjaga alur tamu tetap berjalan. Anda dapat menyelesaikan check-in dan meninjau log nanti.

Pengaturan	Yang Dikendalikan	Hasil
Government Integration	Mengaktifkan alat onboarding EVA	Anda dapat memulai onboarding STB
EVA Environment	Memilih lalu lintas sandbox (TEST) atau produksi (LIVE)	Langsung disimpan; LIVE memerlukan konfirmasi
Hotel Code	Pengenal hotel yang digunakan dalam permintaan EVA	Langkah 2 terbuka setelah disimpan
JWKS	Kunci penandatanganan EVA dan konfirmasi Langkah 3	Langkah 4 terbuka setelah Anda mengonfirmasi pengiriman
EVA API Key	Kredensial untuk panggilan transaksi EVA	Transaksi pengujian dapat dijalankan setelah penyimpanan yang valid
EVA skip rule	Mencegah pengiriman EVA yang tidak perlu	Tamu terkait Singapura tetap melanjutkan tanpa panggilan EVA
Generate New JWKS	Mengganti kredensial onboarding yang ada	Anda harus mengulangi Langkah 3-6

Sebelum Memulai

• Negara hotel Anda adalah Singapore.
• Anda memiliki izin Settings read dan akses penulisan pengaturan untuk menyimpan perubahan.
• Anda mengetahui kode hotel STB Anda.
• Anda dapat mengakses formulir STB dan tautan pengiriman JWKS.

Pengguna tanpa izin settings:write dapat melihat pengaturan, tetapi tidak dapat mengubahnya.

Menemukan Penyiapan STB EVA

1. Buka Government Compliance.
2. Buka Singapore → STB EVA.
3. Pilih Start STB EVA setup, Continue setup, atau Resolve setup.

Gunakan Command Center → Analytics saat ingin melihat kesehatan pengiriman. Jika onboarding belum selesai, Analytics menampilkan STB EVA setup required.

Tautan lama

Tautan lama Settings → Government Integration tetap mengarahkan ke penyiapan STB EVA.

Penyiapan Langkah demi Langkah

1. Buka Government Compliance → Singapore → STB EVA.

2. Aktifkan Government Integration.

3. Di EVA Environment, pilih TEST atau LIVE.

   • Pilih TEST hanya untuk merchant sandbox STB yang disetujui server.
   • Pilih LIVE hanya setelah STB menyetujui kredensial produksi Anda.
   • Jika nilai yang tersimpan tidak ada atau tidak didukung, Streamliner menampilkan TEST.

   ✓ Lingkungan langsung disimpan setelah pilihan yang valid.

4. Jika memilih LIVE, tinjau peringatannya lalu klik Switch to LIVE. Pilih Cancel untuk mempertahankan lingkungan saat ini.

   ✓ Mengubah environment tidak mengganti kode hotel atau kredensial EVA Anda.

5. Masukkan kode hotel Anda lalu klik Save Hotel Code.

   ✓ Sekarang Anda dapat memulai Langkah 2.

6. Di Step 2, klik View guide for FormSG questions 1–15.

7. Biarkan panduan tetap terbuka saat mengisi aplikasi FormSG STB resmi.

8. Tutup panduan, lalu klik Open STB Form.

9. Kirim formulir onboarding STB.

10. Kembali ke Streamliner lalu klik I have submitted the form.

✓ Status Step 2 berubah menjadi Completed.

11. Di Step 3, klik Generate JWKS.
12. Klik Download JWKS txt.
13. Klik Submit JWKS Form lalu selesaikan pengiriman JWKS ke STB.
14. Kembali ke Streamliner lalu klik I have submitted the JWKS.
15. Di popup konfirmasi, klik Yes, I have submitted the JWKS.

✓ Status Step 3 berubah menjadi Completed.

16. Di Step 4, masukkan API key yang diberikan STB lalu klik Save API Key.

ℹ️ Jika key pernah disimpan sebelumnya, kolom menampilkan tanda bintang yang disamarkan sampai Anda mengekliknya.

17. Tunggu validasi otomatis.

✓ Jika berhasil, Streamliner menyimpan key dan memulai transaksi pengujian.

18. Di Step 5, salin ID transaksi. Jika perlu, klik Re-generate Test Transaction.
19. Di Step 5, klik Send Automated Email to STB.
20. Tunggu email konfirmasi konektivitas dari STB.
21. Di Step 6, klik Mark STB Confirmation Received.

✓ Status Step 6 berubah menjadi Completed.

Menyelesaikan aplikasi FormSG

Gunakan panduan di dalam produk yang berada di samping aplikasi FormSG resmi. Vouch tidak mengirimkan formulir untuk Anda. Konfirmasikan detail hukum dengan perwakilan hotel yang berwenang sebelum mengirimkannya.

Pertanyaan FormSG	Yang harus dimasukkan atau dipilih
1. Requested API Services	Pilih E-Visitor Authentication (for Hotel Applicants).
2. Justifications	Masukkan teks siap salin di bawah. Teks tersebut menjelaskan check-in otomatis dan persetujuan tamu.
3. Country of Incorporation	Masukkan negara pendirian resmi organisasi pemohon, bukan lokasi hotel.
4. Organisation Name	Masukkan nama resmi yang tepat. Entitas Singapura harus sesuai dengan catatan Corppass.
5. Hotel Name and Hotel Code	Masukkan nama properti dan kode hotel HLB Anda. Pemohon vendor tanpa mitra hotel memasukkan N.A..
6. Email Address for Test Environment	Gunakan email operasional yang dipantau. STB menggunakannya untuk notifikasi produksi.
7. Reason for APEX JWT Request	Masukkan: Contactless check-in integration, implemented via appointed technology vendor Vouch Technologies on the hotel's behalf.
8. Nature of Business	Masukkan teks siap salin di bawah. Sertakan situs web resmi jika tersedia.
9–13. Contact details	Masukkan sapaan, nama resmi, jabatan, dan industri peminta. Hospitality atau ICT biasanya sesuai.
14. Applicant type	Pilih Hotel Applicant. Hotel Anda memiliki kredensial EVA.
15. Technology provider	Masukkan Vouch Technologies. Gunakan nama resminya jika STB meminta format lain.

Teks FormSG siap salin

Untuk Question 2, masukkan: EVA will be used for authorised, automated hotel check-in, and the hotel will obtain guest consent before any data is submitted.

Untuk Question 8, masukkan: 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.

Konfirmasikan detail pemohon

Hotel mengajukan dan memiliki kredensial EVA. Vouch Technologies mendukung integrasi sebagai penyedia teknologi yang ditunjuk. Periksa semua detail hukum sebelum mengirimkan formulir resmi.

Setelah mengirimkan formulir

1. STB mungkin memerlukan waktu hingga 7 hari kerja untuk meninjau permintaan Anda.
2. Selesaikan pengujian konektivitas dalam 14 hari kalender setelah menerima key pengujian.
3. Bagikan bukti pengujian yang berhasil kepada STB sebelum meminta kredensial produksi.

Menggunakan akses pengujian sandbox dengan aman

Hanya merchant sandbox yang disetujui server yang dapat melihat Test access. Transaksi pengujian sandbox menggunakan STB TEST. Transaksi tersebut tidak dapat menghubungi STB live atau mencatat konfirmasi live.

1. Buka Government Compliance → Singapore → STB EVA.
2. Klik Test access saat opsi tersebut muncul.
3. Pastikan halaman menyatakan bahwa akses sandbox telah disetujui.
4. Kembali ke STB EVA setup dan selesaikan alur TEST yang disetujui.

Jangan mengalihkan merchant sandbox ke LIVE.

LIVE memerlukan persetujuan produksi

Alihkan ke LIVE hanya setelah STB menyetujui akses produksi dan memberikan kredensial produksi. Dialog konfirmasi membantu mencegah lalu lintas produksi yang tidak disengaja.

Jika pengiriman otomatis hanya mengirim email kepada Anda

Jika Anda melihat peringatan ⚠️ seperti "We sent this test transaction to your email only", Streamliner tidak mengirimkan email ke STB.

Teruskan email tersebut ke STB. Kemudian tunggu konfirmasi STB dan selesaikan Step 6.

Pembuatan JWKS Baru Mengganti Kredensial yang Ada

Jika key sudah ada, pembuatan JWKS baru akan menggantikan key lama dan menghapus progres onboarding berikutnya. Anda harus mengulangi Langkah 3-6, termasuk penyimpanan API key, transaksi pengujian, dan konfirmasi STB.

Pemecahan Masalah

EVA dilewati untuk tamu terkait Singapura

Yang Anda lihat: Tamu menyelesaikan check-in tanpa pengiriman EVA.

Perbaikan:

1. Periksa kewarganegaraan tamu dan negara penerbit dokumen.
2. Jika salah satunya terdeteksi sebagai Singapura, anggap EVA yang dilewati sebagai perilaku yang diharapkan.
3. Lanjutkan alur check-in tanpa mengirim tamu ke EVA lagi.

Tombol Step 2 dinonaktifkan

Yang Anda lihat: Anda tidak dapat mengonfirmasi pengiriman formulir.

Perbaikan:

1. Simpan nilai di Hotel Code.
2. Pastikan Government Integration diaktifkan.
3. Coba lagi.

Step 3 tidak dapat dikonfirmasi

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

Perbaikan:

1. Buat atau timpa JWKS terlebih dahulu.
2. Kirim JWKS dalam formulir STB.
3. Kembali lalu klik tombol konfirmasi.
4. Selesaikan popup konfirmasi.

Penyimpanan API key diblokir dengan pesan Step 3

Yang Anda lihat: Pesan kesalahan meminta Anda menyelesaikan Step 3 sebelum menyimpan EVA API key.

Perbaikan:

1. Kembali ke Step 3.
2. Klik I have submitted the JWKS.
3. Konfirmasi popup.
4. Coba lagi Save API Key di Step 4.

Penyimpanan API key gagal

Yang Anda lihat: Pesan kesalahan menyatakan bahwa format API key tidak valid.

Perbaikan:

1. Periksa apakah key memiliki format UUID lengkap.
2. Hapus spasi tambahan.
3. Simpan lagi.

Kolom API key hanya menampilkan tanda bintang

Yang Anda lihat: Step 4 menampilkan ********-****-****-****-************.

Perbaikan:

1. Klik di dalam kolom API key.
2. Tempel nilai key baru.
3. Klik Save API Key.

Transaksi pengujian gagal

Yang Anda lihat: Step 5 menampilkan pesan kesalahan.

Perbaikan:

1. Pastikan EVA Environment sudah disimpan.
2. Pastikan Step 3 dan Step 4 sudah selesai.
3. Klik Re-generate Test Transaction.
4. Jika gagal lagi, hubungi dukungan.

Lingkungan EVA tidak dapat diubah

Yang Anda lihat: Streamliner menolak pilihan TEST atau LIVE Anda.

Perbaikan:

1. Merchant sandbox harus tetap menggunakan TEST.
2. Merchant non-sandbox tidak dapat beralih ke TEST tanpa persetujuan sandbox.
3. Pastikan Anda memiliki izin settings:write.
4. Hubungi Vouch Support jika kebijakan tersebut tidak sesuai dengan hotel Anda.

Perubahan lingkungan EVA gagal disimpan

Yang Anda lihat: Selector kembali ke nilai sebelumnya setelah pilihan dibuat.

Perbaikan:

1. Tunggu pesan berhasil atau pesan kesalahan.
2. Coba pilihan tersebut sekali lagi.
3. Pastikan konteks hotel Anda sudah benar.
4. Hubungi dukungan dengan pesan kesalahan yang tepat jika penyimpanan tetap gagal.

STB mengembalikan B18 atau C18

Yang Anda lihat: STB menolak pengiriman dengan B18, C18, atau keduanya.

Perbaikan:

1. Periksa apakah MRZ buram, terpotong, terlalu panjang, atau tertutup.
2. Pindai ulang dokumen perjalanan agar seluruh MRZ terlihat jelas dan sesuai dengan paspor.
3. Pastikan detail tamu sama persis dengan paspor.
4. Coba kirim lagi.
5. Jika masih gagal, hubungi dukungan dengan ID transaksi.

Mengapa ini biasanya membantu

AVA kini memprioritaskan data MRZ yang akan dikirim ke STB dalam kondisi bersih. OCR yang buruk atau data dokumen yang tidak cocok masih dapat memicu C18.

Pengiriman otomatis menampilkan peringatan bahwa hanya email Anda yang menerima

Yang Anda lihat: Peringatan ⚠️ berbunyi "We sent this test transaction to your email only" setelah Anda mengeklik Send Automated Email to STB.

Perbaikan:

1. Periksa kotak masuk Anda untuk menemukan email transaksi.
2. Teruskan email tersebut ke STB.
3. Tunggu konfirmasi STB, lalu selesaikan Step 6.
4. Hubungi dukungan jika Anda ingin pengiriman email STB otomatis diaktifkan untuk properti Anda.

Onboarding tersembunyi dengan peringatan SG

Yang Anda lihat: Pesan menyatakan bahwa onboarding EVA hanya untuk Singapura.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.
2. Pastikan Country adalah Singapore.
3. Buka Government Compliance → Singapore → STB EVA.

Masih Mengalami Kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Status langkah tidak diperbarui setelah disimpan
• ❌ Konfirmasi STB gagal setelah beberapa kali mencoba
• ❌ Pengiriman otomatis terus-menerus gagal

Detail yang sebaiknya disertakan:

• Tangkapan layar halaman Government Integration
• Teks pesan kesalahan yang tepat
• Waktu masalah mulai terjadi

Panduan Terkait

• Menyiapkan Detail Dasar Hotel
• Koneksi PMS
• Pengaturan Tidak Tersimpan Setelah Berpindah Hotel