ข้ามไปยังเนื้อหาหลัก

การตั้งค่า STB EVA แบบครบถ้วน

หน้านี้เรียงลำดับ onboarding ของ STB EVA ตั้งแต่บันทึก Hotel Code ไปจนถึงยืนยันผลทดสอบกับ STB.

ตั้งค่าอย่างรวดเร็ว

ทำครบ 6 ขั้นตอนเพื่อเปิดใช้งานการรายงานตามข้อกำหนดของรัฐบาลสิงคโปร์ โรงแรมส่วนใหญ่ใช้เวลา 15-25 นาที

คู่มือนี้จะพาคุณทำขั้นตอน STB E-Visitor Authentication (EVA) onboarding จาก Settings → Government Integration

ขั้นตอนการดำเนินการสิ่งที่ต้องเตรียม
1บันทึก Hotel Codeรหัส Hotel Licensing Board (HLB)
2ส่งฟอร์ม STBสิทธิ์เข้าถึง form.gov.sg
3สร้างและส่ง JWKSลิงก์สำหรับส่ง JWKS
4กรอก EVA API KeyAPI key จากอีเมลของ STB
5สร้างและแจ้ง STBtest transaction พร้อมใช้งาน
6รอการยืนยันจาก STBอีเมลอนุมัติจาก STB

ก่อนเริ่ม​

โปรดยืนยันว่าคุณมีสิ่งต่อไปนี้:

  • ประเทศของโรงแรมถูกตั้งค่าเป็น Singapore
  • คุณมีสิทธิ์ Settings write
  • คุณมี รหัส Hotel Licensing Board (HLB)
  • คุณสามารถเปิดฟอร์ม STB ภายนอกได้
ดู Hotel Code ได้จากที่ไหน

หากคุณไม่ทราบรหัส HLB ของโรงแรม ให้ค้นหาโรงแรมของคุณที่ licence1.business.gov.sg/hotelreg/search

ขั้นตอน Onboarding แบบทีละขั้น​

ขั้นตอนที่ 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 Code จาก Hotel Licensing Board

  4. คลิก Save Hotel Code

    ✓ คุณจะเห็นข้อความ "Hotel code saved successfully"

บันทึกไม่ได้?

ตรวจสอบว่า Government Integration ถูกเปิดอยู่แล้ว (toggle เป็นสีน้ำเงิน) ก่อนบันทึก hotel code

ขั้นตอนที่ 2: ส่งฟอร์ม Onboarding STB EVA​

Step 2 showing Open STB Form button and confirmation action

  1. ในส่วน Step 2 คลิก Open STB Form

  2. กรอกแบบฟอร์ม HIS-EVA Hotel Onboarding Application ที่ form.gov.sg ให้ครบถ้วน

  3. กลับมาที่ Streamliner

  4. คลิก I have submitted the form

  5. ใน popup ยืนยัน คลิก 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. ยืนยันใน popup

    ✓ Step 3 จะแสดงว่าเสร็จสมบูรณ์

หากคุณมีข้อมูลรับรองจาก STB อยู่แล้ว​

บางโรงแรมอาจได้รับข้อมูลรับรอง JWKS จาก STB โดยตรง ในกรณีนี้ให้ใช้ Override Keys แทนการสร้างคีย์ใหม่:

Advanced options expanded showing Override Keys button

  1. ใน Step 3 เปิด Advanced options

  2. คลิก Override Keys

  3. ใน modal ที่ปรากฏ ให้กรอกข้อมูลรับรองที่คุณมีอยู่:

    • 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. ตรวจสอบอีเมลของคุณเพื่อหาอีเมลหัวข้อ "EVA API Key" จาก STB

  2. คัดลอก API key (อยู่ในรูปแบบ UUID)

  3. กลับไปที่ Step 4 ใน Streamliner

  4. วาง key ลงในช่อง Enter EVA API Key

  5. คลิก Save API Key

    ✓ ระบบจะตรวจสอบ key โดยอัตโนมัติ ✓ คุณจะเห็นข้อความ "API key saved successfully"

การตรวจสอบใช้เวลาเล็กน้อย

ระบบจะทดสอบ API key ของคุณกับ endpoint ของ STB ซึ่งใช้เวลาประมาณ 5-10 วินาที อย่าปิดหน้าระหว่างการตรวจสอบ

ขั้นตอนที่ 5: สร้าง Test Transaction และแจ้ง STB​

Step 5 showing test transaction ID and notification options

หลังจากบันทึก API key แล้ว ระบบจะสร้าง test transaction ให้อัตโนมัติ

  1. รอให้ระบบสร้าง test transaction

    ✓ คุณจะเห็น transaction ID ที่ STB ส่งกลับมา

  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

ติดต่อ success@vouch-technologies.com หากคุณต้องการเปิดใช้งานการแจ้ง STB แบบอัตโนมัติสำหรับโรงแรมของคุณ

ขั้นตอนที่ 6: รอการยืนยันจาก STB​

Step 6 showing waiting status and confirmation button

STB จะตรวจสอบ test transaction ของคุณและยืนยันว่าการเชื่อมต่อสำเร็จแล้ว

  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 integration ของคุณเปิดใช้งานแล้ว! ข้อมูลการเช็กอินของผู้เข้าพักจะถูกส่งไปยัง STB โดยอัตโนมัติ

การจัดการ Integration ของคุณ​

สร้าง Test Transaction ใหม่​

หาก test transaction หมดอายุหรือไม่สำเร็จ:

  1. ไปที่ Step 5
  2. คลิก Re-generate Test Transaction
  3. แจ้ง STB โดยใช้ transaction ID ใหม่

รีเซ็ต Onboarding​

หากคุณต้องการเริ่มใหม่ทั้งหมด:

  1. ติดต่อ success@vouch-technologies.com
  2. ขอให้รีเซ็ต EVA onboarding
  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. ส่งฟอร์ม STB ที่ form.gov.sg ให้เรียบร้อยจริง
  3. กลับมาแล้วกดปุ่มยืนยัน

Override Keys ไม่สำเร็จ​

สิ่งที่คุณเห็น: เกิดข้อผิดพลาดตอนบันทึกข้อมูลรับรองที่ override

วิธีแก้:

  • ตรวจสอบว่า JWKS เป็น JSON ที่ถูกต้อง
  • ตรวจสอบว่า public key และ private key เป็นรูปแบบ PEM พร้อม header ที่ถูกต้อง (-----BEGIN PUBLIC KEY-----)
  • ตรวจสอบว่ากรอกอย่างน้อยหนึ่งช่องแล้ว (JWKS, public key หรือ private key)

การตรวจสอบ API key ไม่ผ่าน​

สิ่งที่คุณเห็น: เกิดข้อผิดพลาดหลังคลิก Save API Key

วิธีแก้:

  1. ตรวจสอบว่า key ครบถ้วน (36 ตัวอักษรรวมเครื่องหมายขีด)
  2. ลบช่องว่างหน้าและหลัง key
  3. ตรวจสอบว่าคุณใช้ key แบบ TEST หรือ LIVE ให้ตรงกับ environment ที่เลือก
  4. ตรวจสอบว่า Step 3 (JWKS) เสร็จแล้ว