ตั้งค่า STB EVA Government Integration

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

เปิด Government Integration เลือก TEST/LIVE แล้วทำตามขั้นตอน onboarding ทั้ง 6 ขั้นตามลำดับ โรงแรมส่วนใหญ่ทำเสร็จภายใน 10-20 นาที

คู่มือนี้ช่วยให้คุณทำ onboarding ของ Singapore STB EVA จาก Government Compliance ได้เสร็จสมบูรณ์

เมื่อข้าม EVA

AVA จะข้าม EVA เมื่อสัญชาติของผู้เข้าพักหรือรัฐที่ออกเอกสารระบุเป็น Singapore หากทั้งสองค่าไม่ใช่ Singapore AVA จะส่งผู้เข้าพักไปยัง EVA

หลังการยืนยันใบหน้า

หากการส่งข้อมูลไปยัง EVA ล้มเหลวหลังการยืนยันใบหน้า AVA จะบันทึกข้อผิดพลาดและให้โฟลว์ผู้เข้าพักดำเนินต่อ คุณสามารถเช็กอินให้เสร็จ แล้วกลับมาตรวจสอบ log ภายหลังได้

การตั้งค่า	ควบคุมอะไร	ผลลัพธ์
Government Integration	เปิดใช้เครื่องมือ onboarding ของ EVA	คุณสามารถเริ่ม onboarding ของ STB ได้
EVA Environment	เลือกทราฟฟิก sandbox (TEST) หรือ production (LIVE)	บันทึกทันที ส่วน LIVE ต้องยืนยัน
Hotel Code	ตัวระบุโรงแรมที่ใช้ในคำขอ EVA	Step 2 จะปลดล็อกหลังบันทึก
JWKS	คีย์สำหรับลงนามของ EVA และการยืนยัน Step 3	Step 4 จะปลดล็อกหลังคุณยืนยันการส่ง
EVA API Key	ข้อมูลรับรองสำหรับการเรียกธุรกรรม EVA	สามารถทำธุรกรรมทดสอบได้หลังบันทึกค่าที่ถูกต้อง
EVA skip rule	ป้องกันการส่งข้อมูลไปยัง EVA โดยไม่จำเป็น	ผู้เข้าพักที่เกี่ยวข้องกับ Singapore จะดำเนินการต่อโดยไม่เรียก EVA
Generate New JWKS	แทนที่ข้อมูลรับรอง onboarding ที่มีอยู่	คุณต้องทำ Steps 3-6 ซ้ำ

ก่อนเริ่มต้น

• ประเทศของโรงแรมคือ Singapore
• คุณมีสิทธิ์ Settings read และมีสิทธิ์เขียน settings เพื่อบันทึกค่า
• คุณทราบ STB hotel code ของโรงแรม
• คุณเข้าถึงแบบฟอร์ม STB และลิงก์ส่ง JWKS ได้

ผู้ใช้ที่ไม่มี settings:write สามารถดูการตั้งค่าได้ แต่ไม่สามารถเปลี่ยนแปลงได้

ค้นหาการตั้งค่า STB EVA

1. เปิด Government Compliance
2. เปิด Singapore → STB EVA
3. เลือก Start STB EVA setup, Continue setup หรือ Resolve setup

ใช้ Command Center → Analytics เมื่อต้องการดูสถานะการส่งข้อมูล หาก onboarding ยังไม่เสร็จ Analytics จะแสดง STB EVA setup required

ลิงก์เดิม

ลิงก์ Settings → Government Integration แบบเดิมยังคง redirect ไปยังการตั้งค่า STB EVA

ขั้นตอนการตั้งค่าแบบทีละขั้น

1. เปิด Government Compliance → Singapore → STB EVA

2. เปิด Government Integration

3. ใน EVA Environment เลือก TEST หรือ LIVE

   • เลือก TEST เฉพาะ merchant sandbox ที่ STB อนุมัติสำหรับเซิร์ฟเวอร์แล้ว
   • เลือก LIVE เฉพาะหลังจาก STB อนุมัติข้อมูลรับรอง production ของคุณแล้ว
   • หากไม่มีค่าที่บันทึกไว้หรือค่าไม่รองรับ Streamliner จะแสดง TEST

   ✓ Environment จะถูกบันทึกทันทีหลังเลือกค่าที่ถูกต้อง

4. หากเลือก LIVE ให้อ่านคำเตือนแล้วคลิก Switch to LIVE เลือก Cancel เพื่อคง environment ปัจจุบันไว้

   ✓ การเปลี่ยน environment จะไม่แทนที่ hotel code หรือข้อมูลรับรอง EVA ของคุณ

5. กรอก hotel code แล้วคลิก Save Hotel Code

   ✓ ตอนนี้คุณสามารถเริ่ม Step 2 ได้

6. ใน Step 2 คลิก View guide for FormSG questions 1–15

7. เปิดคู่มือนี้ไว้ขณะกรอกใบสมัคร STB FormSG อย่างเป็นทางการ

8. ปิดคู่มือ แล้วคลิก Open STB Form

9. ส่งแบบฟอร์ม onboarding ของ STB

10. กลับไปที่ Streamliner แล้วคลิก I have submitted the form

✓ สถานะ Step 2 จะเปลี่ยนเป็น Completed

11. ใน Step 3 คลิก Generate JWKS
12. คลิก Download JWKS txt
13. คลิก Submit JWKS Form แล้วดำเนินการส่ง JWKS ให้ STB
14. กลับไปที่ Streamliner แล้วคลิก I have submitted the JWKS
15. ใน popup ยืนยัน คลิก Yes, I have submitted the JWKS

✓ สถานะ Step 3 จะเปลี่ยนเป็น Completed

16. ใน Step 4 กรอก API key ที่ STB ออกให้ แล้วคลิก Save API Key

ℹ️ หากเคยบันทึก key ไว้แล้ว ช่องจะแสดงดอกจันที่ปิดบังจนกว่าคุณจะคลิกเข้าไป

17. รอการตรวจสอบอัตโนมัติ

✓ หากสำเร็จ Streamliner จะบันทึก key และเริ่มธุรกรรมทดสอบ

18. ใน Step 5 คัดลอก transaction ID หากจำเป็น ให้คลิก Re-generate Test Transaction
19. ใน Step 5 คลิก Send Automated Email to STB
20. รออีเมลยืนยันการเชื่อมต่อจาก STB
21. ใน Step 6 คลิก Mark STB Confirmation Received

✓ สถานะ Step 6 จะเปลี่ยนเป็น Completed

กรอกใบสมัคร FormSG ให้เสร็จสมบูรณ์

ใช้คู่มือในผลิตภัณฑ์ที่อยู่ข้างใบสมัคร FormSG อย่างเป็นทางการ Vouch จะไม่ส่งแบบฟอร์มแทนคุณ ยืนยันรายละเอียดทางกฎหมายกับตัวแทนโรงแรมที่ได้รับอนุญาตก่อนส่งแบบฟอร์ม

คำถาม FormSG	สิ่งที่ต้องกรอกหรือเลือก
1. Requested API Services	เลือก E-Visitor Authentication (for Hotel Applicants)
2. Justifications	กรอกข้อความที่เตรียมไว้ด้านล่าง ซึ่งอธิบายการเช็กอินอัตโนมัติและความยินยอมของผู้เข้าพัก
3. Country of Incorporation	กรอกประเทศที่องค์กรผู้สมัครจดทะเบียนตามกฎหมาย ไม่ใช่สถานที่ตั้งโรงแรม
4. Organisation Name	กรอกชื่อตามกฎหมายให้ตรงทุกตัว องค์กรใน Singapore ควรตรงกับข้อมูลใน Corppass
5. Hotel Name and Hotel Code	กรอกชื่อที่พักและ HLB hotel code ผู้สมัครที่เป็น vendor และยังไม่มีพาร์ทเนอร์โรงแรมให้กรอก N.A.
6. Email Address for Test Environment	ใช้อีเมลปฏิบัติการที่มีผู้ตรวจสอบ STB ใช้อีเมลนี้สำหรับการแจ้งเตือน production
7. Reason for APEX JWT Request	กรอก: Contactless check-in integration, implemented via appointed technology vendor Vouch Technologies on the hotel's behalf.
8. Nature of Business	กรอกข้อความที่เตรียมไว้ด้านล่าง และใส่เว็บไซต์ทางการเมื่อมี
9–13. Contact details	กรอกคำนำหน้า ชื่อตามกฎหมาย ตำแหน่งงาน และอุตสาหกรรมของผู้ร้องขอ โดยทั่วไป Hospitality หรือ ICT เหมาะสม
14. Applicant type	เลือก Hotel Applicant โรงแรมของคุณเป็นเจ้าของข้อมูลรับรอง EVA
15. Technology provider	กรอก Vouch Technologies ใช้ชื่อตามกฎหมายหาก STB ขอรูปแบบอื่น

ข้อความ FormSG ที่คัดลอกไปใช้ได้

สำหรับ Question 2 ให้กรอก: EVA will be used for authorised, automated hotel check-in, and the hotel will obtain guest consent before any data is submitted.

สำหรับ Question 8 ให้กรอก: 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.

ยืนยันรายละเอียดผู้สมัคร

โรงแรมเป็นผู้สมัครและเป็นเจ้าของข้อมูลรับรอง EVA Vouch Technologies สนับสนุนการเชื่อมต่อในฐานะผู้ให้บริการเทคโนโลยีที่ได้รับการแต่งตั้ง ตรวจสอบรายละเอียดทางกฎหมายทั้งหมดก่อนส่งแบบฟอร์มอย่างเป็นทางการ

หลังส่งแบบฟอร์ม

1. STB อาจใช้เวลาสูงสุด 7 วันทำการ ในการตรวจสอบคำขอ
2. ดำเนินการทดสอบการเชื่อมต่อให้เสร็จภายใน 14 วันปฏิทิน หลังได้รับ test keys
3. แชร์หลักฐานการทดสอบที่สำเร็จให้ STB ก่อนขอข้อมูลรับรอง production

ใช้ sandbox test access อย่างปลอดภัย

เฉพาะ merchant sandbox ที่เซิร์ฟเวอร์อนุมัติแล้วเท่านั้นที่จะเห็น Test access ธุรกรรมทดสอบ sandbox ใช้ STB TEST ธุรกรรมเหล่านี้จะไม่ติดต่อ STB live หรือบันทึกการยืนยัน live

1. เปิด Government Compliance → Singapore → STB EVA
2. คลิก Test access เมื่อปรากฏขึ้น
3. ยืนยันว่าหน้าระบุว่า sandbox access ได้รับการอนุมัติ
4. กลับไปที่ STB EVA setup แล้วทำโฟลว์ TEST ที่ได้รับอนุมัติให้เสร็จ

อย่าสลับ merchant sandbox ไปเป็น LIVE

LIVE ต้องได้รับอนุมัติ production

เปลี่ยนเป็น LIVE เฉพาะหลังจาก STB อนุมัติ production access และให้ข้อมูลรับรอง production แล้ว กล่องโต้ตอบยืนยันช่วยป้องกันการส่งทราฟฟิกไปยัง production โดยไม่ตั้งใจ

หากการส่งอัตโนมัติส่งอีเมลถึงคุณเท่านั้น

หากเห็นคำเตือน ⚠️ เช่น "We sent this test transaction to your email only" แสดงว่า Streamliner ไม่ได้ส่งอีเมลให้ STB

ให้ forward อีเมลไปยัง STB จากนั้นรอการยืนยันจาก STB และทำ Step 6 ให้เสร็จ

การสร้าง New JWKS จะแทนที่ข้อมูลรับรองเดิม

หากมีคีย์อยู่แล้ว การสร้าง JWKS ใหม่จะแทนที่คีย์เก่าและล้างความคืบหน้า onboarding ในขั้นตอนถัดไป คุณต้องทำ Steps 3-6 ซ้ำ รวมถึงการบันทึก API key ธุรกรรมทดสอบ และการยืนยันจาก STB

การแก้ไขปัญหา

EVA ถูกข้ามสำหรับผู้เข้าพักที่เกี่ยวข้องกับ Singapore

สิ่งที่คุณเห็น: ผู้เข้าพักเช็กอินเสร็จโดยไม่มีการส่งข้อมูลไปยัง EVA

วิธีแก้:

1. ตรวจสอบสัญชาติของผู้เข้าพักและรัฐที่ออกเอกสาร
2. หากค่าใดค่าหนึ่งระบุเป็น Singapore ให้ถือว่าการข้าม EVA เป็นพฤติกรรมที่คาดไว้
3. ดำเนินโฟลว์เช็กอินต่อโดยไม่ส่งผู้เข้าพักไปยัง EVA อีกครั้ง

ปุ่ม Step 2 ถูกปิดใช้งาน

สิ่งที่คุณเห็น: คุณไม่สามารถยืนยันการส่งแบบฟอร์มได้

วิธีแก้:

1. บันทึกค่าใน Hotel Code
2. ยืนยันว่าเปิดใช้ Government Integration แล้ว
3. ลองอีกครั้ง

ไม่สามารถยืนยัน Step 3 ได้

สิ่งที่คุณเห็น: I have submitted the JWKS ยังคงปิดใช้งาน

วิธีแก้:

1. สร้างหรือ override JWKS ก่อน
2. ส่ง JWKS ในแบบฟอร์ม STB
3. กลับมาแล้วคลิกปุ่มยืนยัน
4. ดำเนินการใน popup ยืนยันให้เสร็จ

การบันทึก API key ถูกบล็อกด้วยข้อความจาก Step 3

สิ่งที่คุณเห็น: ข้อผิดพลาดแจ้งให้ทำ Step 3 ให้เสร็จก่อนบันทึก EVA API key

วิธีแก้:

1. กลับไปที่ Step 3
2. คลิก I have submitted the JWKS
3. ยืนยันใน popup
4. ลอง Save API Key ใน Step 4 อีกครั้ง

การบันทึก API key ล้มเหลว

สิ่งที่คุณเห็น: ข้อผิดพลาดแจ้งว่ารูปแบบ API key ไม่ถูกต้อง

วิธีแก้:

1. ตรวจสอบว่า key อยู่ในรูปแบบ UUID แบบเต็ม
2. ลบช่องว่างส่วนเกิน
3. บันทึกอีกครั้ง

ช่อง API key แสดงเฉพาะดอกจัน

สิ่งที่คุณเห็น: Step 4 แสดง ********-****-****-****-************

วิธีแก้:

1. คลิกในช่อง API key
2. วางค่า key ใหม่
3. คลิก Save API Key

ธุรกรรมทดสอบล้มเหลว

สิ่งที่คุณเห็น: Step 5 แสดงข้อความข้อผิดพลาด

วิธีแก้:

1. ยืนยันว่าบันทึก EVA Environment แล้ว
2. ยืนยันว่า Step 3 และ Step 4 เสร็จสมบูรณ์
3. คลิก Re-generate Test Transaction
4. หากยังล้มเหลว ให้ติดต่อซัพพอร์ต

ไม่สามารถเปลี่ยน EVA environment ได้

สิ่งที่คุณเห็น: Streamliner ปฏิเสธการเลือก TEST หรือ LIVE ของคุณ

วิธีแก้:

1. merchant sandbox ต้องอยู่ที่ TEST
2. merchant ที่ไม่ใช่ sandbox จะเปลี่ยนเป็น TEST ไม่ได้หากยังไม่ได้รับอนุมัติ sandbox
3. ยืนยันว่าคุณมีสิทธิ์ settings:write
4. ติดต่อ Vouch Support หากนโยบายไม่ตรงกับโรงแรมของคุณ

การบันทึกการเปลี่ยน EVA environment ล้มเหลว

สิ่งที่คุณเห็น: selector กลับไปเป็นค่าก่อนหน้าเมื่อเลือกค่าใหม่

วิธีแก้:

1. รอข้อความสำเร็จหรือข้อความข้อผิดพลาด
2. ลองเลือกอีกครั้งหนึ่งครั้ง
3. ยืนยันว่า hotel context ของคุณถูกต้อง
4. หากยังบันทึกไม่ได้ ให้ติดต่อซัพพอร์ตพร้อมข้อความข้อผิดพลาดแบบตรงตัว

STB ส่ง B18 หรือ C18 กลับมา

สิ่งที่คุณเห็น: STB ปฏิเสธการส่งด้วย B18, C18 หรือทั้งสองค่า

วิธีแก้:

1. ตรวจสอบว่า MRZ เบลอ ถูกตัด ยาวเกินไป หรือมีสิ่งปิดบังหรือไม่
2. สแกนเอกสารเดินทางอีกครั้งให้ MRZ ทั้งหมดชัดเจนและตรงกับหนังสือเดินทาง
3. ยืนยันว่ารายละเอียดผู้เข้าพักตรงกับหนังสือเดินทางทุกประการ
4. ลองส่งอีกครั้ง
5. หากยังล้มเหลว ให้ติดต่อซัพพอร์ตพร้อม transaction ID

เหตุผลที่วิธีนี้มักช่วยได้

ตอนนี้ AVA จะให้ความสำคัญกับข้อมูล MRZ ที่สะอาด ซึ่งจะถูกส่งไปยัง STB OCR ที่ไม่ดีหรือข้อมูลเอกสารไม่ตรงกันยังอาจทำให้เกิด C18 ได้

การส่งอัตโนมัติขึ้นคำเตือนว่าไปที่อีเมลของคุณเท่านั้น

สิ่งที่คุณเห็น: มีคำเตือน ⚠️ ว่า "We sent this test transaction to your email only" หลังจากคลิก Send Automated Email to STB

วิธีแก้:

1. ตรวจสอบกล่องขาเข้าหาอีเมลธุรกรรม
2. forward อีเมลไปยัง STB
3. รอการยืนยันจาก STB แล้วทำ Step 6 ให้เสร็จ
4. ติดต่อซัพพอร์ตหากต้องการเปิดใช้อีเมล STB อัตโนมัติสำหรับที่พักของคุณ

Onboarding ถูกซ่อนพร้อมคำเตือน SG

สิ่งที่คุณเห็น: ข้อความระบุว่า EVA onboarding ใช้ได้เฉพาะ Singapore

วิธีแก้:

1. ไปที่ Settings → Essentials → Hotel Basic Details
2. ยืนยันว่า Country เป็น Singapore
3. เปิด Government Compliance → Singapore → STB EVA

ยังติดปัญหาอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ สถานะ Step ไม่อัปเดตหลังบันทึก
• ❌ การยืนยันจาก STB ล้มเหลวหลังลองหลายครั้ง
• ❌ การส่งอัตโนมัติล้มเหลวซ้ำ ๆ

ข้อมูลที่ควรแนบ:

• ภาพหน้าจอหน้า Government Integration
• ข้อความข้อผิดพลาดแบบตรงตัว
• เวลาที่เริ่มเกิดปัญหา

คู่มือที่เกี่ยวข้อง

• ตั้งค่ารายละเอียดพื้นฐานของโรงแรม
• การเชื่อมต่อ PMS
• การตั้งค่าไม่ถูกบันทึกหลังสลับโรงแรม