Atur Integrasi Pemerintah STB EVA
Aktifkan Government Integration, pilih TEST/LIVE, lalu selesaikan 6 langkah onboarding secara berurutan. Sebagian besar hotel selesai dalam 10-20 menit.
Panduan ini membantu Anda menyelesaikan onboarding Singapore STB EVA dari Settings → Check-in.
AVA melewati EVA ketika kewarganegaraan tamu atau state penerbit dokumen bernilai Singapore. Jika kedua nilai bukan Singapore, AVA mengirim tamu ke EVA.
Jika pengiriman ke EVA gagal setelah verifikasi wajah, AVA mencatat error dan tetap menjaga alur tamu berjalan. Anda bisa menyelesaikan check-in lalu meninjau log nanti.
| Setting | Yang Dikendalikan | Hasil |
|---|---|---|
| Government Integration | Mengaktifkan alat onboarding EVA | Anda bisa memulai onboarding STB |
| EVA Environment | Endpoint EVA tujuan (TEST atau LIVE) | API key dan transaction test dapat dijalankan |
| Hotel Code | Identifier hotel yang digunakan dalam request EVA | Langkah 2 terbuka setelah disimpan |
| JWKS | Kunci penandatangan EVA dan konfirmasi Langkah 3 | Langkah 4 terbuka setelah Anda mengonfirmasi pengiriman |
| EVA API Key | Kredensial untuk panggilan transaction EVA | Transaction test dapat dijalankan setelah penyimpanan valid |
| EVA skip rule | Mencegah pengiriman EVA yang tidak perlu | Tamu terkait Singapore 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 write.
- Anda mengetahui kode hotel STB Anda.
- Anda dapat mengakses formulir STB dan tautan pengiriman JWKS.
Penyiapan Langkah demi Langkah
-
Aktifkan Government Integration.
-
Di Environment, pilih TEST atau LIVE lalu klik Save EVA Environment.
-
Masukkan kode hotel Anda lalu klik Save Hotel Code.
✓ Sekarang Anda dapat memulai Langkah 2.
-
Di Step 2, klik Open STB Form.
-
Kirim formulir onboarding STB.
-
Kembali ke Streamliner lalu klik I have submitted the form.
✓ Status Langkah 2 berubah menjadi Completed.
-
Di Step 3, klik Generate JWKS.
-
Klik Download JWKS txt.
-
Klik Submit JWKS Form lalu selesaikan pengiriman JWKS ke STB.
-
Kembali ke Streamliner lalu klik I have submitted the JWKS.
-
Di popup konfirmasi, klik Yes, I have submitted the JWKS.
✓ Status Langkah 3 berubah menjadi Completed.
- Di Step 4, masukkan API key yang diberikan STB lalu klik Save API Key.
ℹ️ Jika sebelumnya sudah ada key yang tersimpan, field akan menampilkan tanda bintang yang disamarkan sampai Anda mengekliknya.
- Tunggu validasi otomatis.
✓ Jika berhasil, Streamliner menyimpan key dan memulai test transaction.
- Di Step 5, salin transaction ID. Jika perlu, klik Re-generate Test Transaction.
- Di Step 5, klik Send Automated Email to STB.
- Tunggu email konfirmasi konektivitas dari STB.
- Di Step 6, klik Mark STB Confirmation Received.
✓ Status Langkah 6 berubah menjadi Completed.
Jika Anda melihat peringatan ⚠️ seperti "We sent this test transaction to your email only", Streamliner tidak mengirim email ke STB.
Teruskan email itu ke STB. Setelah itu tunggu konfirmasi STB dan selesaikan Langkah 6.
Jika key sudah ada, generate JWKS baru akan menggantikan key lama dan menghapus progres onboarding berikutnya. Anda harus mengulangi Langkah 3-6, termasuk penyimpanan API key, test transaction, dan konfirmasi STB.
Pemecahan Masalah
EVA dilewati untuk tamu terkait Singapore
Yang Anda lihat: Tamu menyelesaikan check-in tanpa pengiriman EVA.
Perbaikan:
- Periksa kewarganegaraan tamu dan state penerbit dokumen.
- Jika salah satunya bernilai Singapore, anggap EVA yang dilewati sebagai perilaku yang diharapkan.
- Lanjutkan alur check-in tanpa mengirim tamu ke EVA lagi.
Tombol Langkah 2 dinonaktifkan
Yang Anda lihat: Anda tidak dapat mengonfirmasi pengiriman formulir.
Perbaikan:
- Simpan nilai di Hotel Code.
- Pastikan Government Integration aktif.
- Coba lagi.
Langkah 3 tidak dapat dikonfirmasi
Yang Anda lihat: I have submitted the JWKS tetap nonaktif.
Perbaikan:
- Generate atau override JWKS terlebih dahulu.
- Kirim JWKS di formulir STB.
- Kembali lalu klik tombol konfirmasi.
- Selesaikan popup konfirmasi.
Penyimpanan API key diblokir dengan pesan Langkah 3
Yang Anda lihat: Pesan error meminta Anda menyelesaikan Step 3 sebelum menyimpan EVA API key.
Perbaikan:
- Kembali ke Step 3.
- Klik I have submitted the JWKS.
- Konfirmasi popup.
- Coba lagi Save API Key di Step 4.
Penyimpanan API key gagal
Yang Anda lihat: Pesan error mengatakan format API key tidak valid.
Perbaikan:
- Periksa apakah key berbentuk UUID lengkap.
- Hapus spasi tambahan.
- Simpan lagi.
Field API key hanya menampilkan tanda bintang
Yang Anda lihat: Step 4 menampilkan ********-****-****-****-************.
Perbaikan:
- Klik di dalam field API key.
- Tempel nilai key baru.
- Klik Save API Key.
Test transaction gagal
Yang Anda lihat: Step 5 menampilkan pesan error.
Perbaikan:
- Pastikan EVA Environment sudah disimpan.
- Pastikan Step 3 dan Step 4 sudah selesai.
- Klik Re-generate Test Transaction.
- Jika gagal lagi, hubungi support.
STB mengembalikan B18 atau C18
Yang Anda lihat: STB menolak pengiriman dengan B18, C18, atau keduanya.
Perbaikan:
- Periksa apakah MRZ buram, terpotong, atau tertutup.
- Jika ya, pindai ulang dokumen perjalanan dengan MRZ terlihat penuh.
- Pastikan detail tamu cocok persis dengan paspor.
- Coba kirim lagi.
- Jika dokumen masih gagal, hubungi support dengan transaction ID.
Pengiriman otomatis menampilkan peringatan bahwa hanya email Anda yang dipakai
Yang Anda lihat: Peringatan ⚠️ mengatakan "We sent this test transaction to your email only" setelah Anda mengeklik Send Automated Email to STB.
Perbaikan:
- Periksa inbox Anda untuk email transaction.
- Teruskan email itu ke STB.
- Tunggu konfirmasi STB, lalu selesaikan Step 6.
- Hubungi support jika Anda ingin email otomatis ke STB diaktifkan untuk properti Anda.
Onboarding disembunyikan dengan peringatan SG
Yang Anda lihat: Pesan mengatakan onboarding EVA hanya untuk Singapore.
Perbaikan:
- Buka Settings → Essentials → Hotel Basic Details.
- Pastikan Country adalah Singapore.
- Muat ulang dan buka lagi Government Integration.
Masih Terkendala?
Hubungi success@vouch-technologies.com jika:
- ❌ Status langkah tidak berubah setelah menyimpan
- ❌ Konfirmasi STB gagal setelah beberapa kali percobaan
- ❌ Pengiriman otomatis gagal berulang kali
Detail yang membantu untuk disertakan:
- Screenshot halaman Government Integration
- Teks pesan error persisnya
- Waktu masalah mulai terjadi