เกตเวย์การชำระเงิน

ตั้งค่าแบบเร็ว

ตั้งค่าเกตเวย์การชำระเงินก่อน จากนั้นค่อยตั้งกฎเงินมัดจำและกฎนโยบายการชำระเงินของ Opera โรงแรมส่วนใหญ่ทำเสร็จภายใน 5 นาที

คู่มือนี้ช่วยคุณตั้งค่ากฎการรับชำระเงินในหน้า Payment แบบใหม่

ตำแหน่งเมนู

Settings → Payment

อ้างอิงแบบย่อ

พื้นที่การตั้งค่า	ควบคุมอะไร	ผลลัพธ์หลัก
Payment Gateway Integration	ตั้งค่า Stripe หรือ Red Dot Payment	ผู้เข้าพักชำระเงินในโฟลว์คีออสก์ได้
Stripe Environment	โหมด Live หรือ Test สำหรับเกตเวย์ Stripe และการเชื่อมต่อเทอร์มินัล	ล็อกค่าไว้หลังเชื่อมต่อ
Payment Collection Mode	สลับเปิดปิดเงินมัดจำและการชำระเต็มจำนวน	ควบคุมว่าผู้เข้าพักต้องจ่ายอะไรตอนเช็กอิน
Property Currency (ใน Settings → Essentials)	สกุลเงินจริงที่ใช้กับเงินมัดจำและการแสดงยอดชำระของการจอง	ทำให้จำนวนเงินสอดคล้องกันทั้งในหน้าตั้งค่าและงานปฏิบัติการ
Deposit Currency	สกุลเงินที่ใช้กับยอดเงินมัดจำบนหน้านี้	บันทึกไปพร้อมกับการตั้งค่าการชำระเงินอื่น ๆ
Opera Payment Mapping (Step 3 card)	การจับคู่ settlement, cashier และประเภทการชำระเงิน	ส่งข้อมูลรับชำระเข้า Opera ได้ถูกต้อง
Opera Payment Policy Controls	กฎปัดเศษ, pre-auth, waive/hide	บังคับพฤติกรรมการชำระเงินเฉพาะ Opera

ก่อนเริ่ม

• เตรียมบัญชีเกตเวย์การชำระเงินของคุณให้พร้อม
• ตัดสินใจว่าจะเก็บเงินมัดจำ เก็บเต็มจำนวน หรือทั้งสองแบบ
• ยืนยันนโยบายเงินมัดจำและแหล่งที่มาของ property currency ใน Settings → Essentials → Hotel Basic Details
• หากใช้ Opera ให้เตรียมค่าที่เกี่ยวข้องกับงานแคชเชียร์และการจับคู่การชำระเงินไว้ล่วงหน้า

ขั้นตอนการตั้งค่า

ขั้นตอนที่ 1: เลือก Payment Gateway

1. ไปที่ Settings → Payment
2. ใน Payment Gateway Integration เลือก Stripe หรือ Red Dot Payment

สำหรับ Stripe

1. เปิด Advanced
2. เลือก Live หรือ Test
3. คลิก Connect Stripe
4. ทำขั้นตอน onboarding ของ Stripe ให้ครบ
5. กลับมาที่ Streamliner และยืนยันว่า Stripe เชื่อมต่อแล้ว

โหมด Stripe

ใช้ Live สำหรับใช้งานจริง และ Test สำหรับการ onboarding ใน sandbox หลัง Stripe เชื่อมต่อแล้ว สภาพแวดล้อมจะเป็นแบบอ่านอย่างเดียวจนกว่าคุณจะยกเลิกการเชื่อมต่อ

การตั้งค่า Stripe สำหรับเทอร์มินัลจะเริ่มที่ Live ด้วยเช่นกัน เว้นแต่คุณจะเปลี่ยนก่อนเชื่อมต่อ

การเช็กเอาต์ผ่านเทอร์มินัล

เมื่อคีออสก์มี Stripe terminal ที่แมปไว้เพียงหนึ่งเครื่อง AVA จะเปิดโฟลว์การชำระเงินผ่านเทอร์มินัลโดยอัตโนมัติระหว่างเช็กเอาต์ เมื่อแมปหลายเครื่อง คุณจะเลือกจากตัวเลือก terminal ใน modal การชำระเงิน หากปิดโหมดเทอร์มินัล AVA จะใช้โฟลว์การชำระเงินผ่าน gateway หรือ QR ต่อไป

สำหรับ Red Dot Payment

1. กรอก Merchant ID
2. กรอก Secret Key
3. เลือก Environment (TEST หรือ LIVE)
4. คลิก Save Payment Gateway Settings

ขั้นตอนที่ 2: เลือกตัวเลือกการรับชำระเงิน

Toggle	ทำอะไร
Collect Security Deposits	ทำการกันวงเงินเงินมัดจำระหว่างเช็กอิน
Collect Full Payment	ให้ผู้เข้าพักชำระยอดคงค้างระหว่างเช็กอิน

1. เปิดอย่างน้อยหนึ่งตัวหรือเปิดทั้งสองตัว
2. หากปิดทั้งสองตัว ระบบเช็กอินจะไม่ขอการชำระเงิน
3. คลิก Save Payment Gateway Settings

ขั้นตอนที่ 3: ตั้งค่ารายละเอียดเงินมัดจำ (ถ้าเปิดใช้งาน)

1. กรอก Deposit Amount
2. เลือก Deposit Type (ต่อคืนหรือยอดคงที่)
3. คลิก Save Payment Gateway Settings

แหล่งที่มาของสกุลเงินเงินมัดจำ

การตั้งค่าการชำระเงินจะใช้ Property Currency ที่ระบบคำนวณแล้วจาก Settings → Essentials → Hotel Basic Details หาก PMS เป็นผู้ส่งสกุลเงิน AVA จะใช้ค่านั้นและล็อกการแก้ไขในระบบ Deposit Currency ที่คุณเลือกจะถูกบันทึกไปพร้อมกับการตั้งค่าการชำระเงินอื่น ๆ

ขั้นตอนที่ 4: ตั้งค่า Opera Payment Mapping (เฉพาะ Opera)

1. ใน Step 3: Configure Opera PMS Payment Mapping ให้ตั้งค่า:
   • Settlement Code
   • Default Cashier ID
   • Default Comment Type / Location
   • แถว Payment Type to Payment Method Code
2. คลิก Save Opera Payment Mapping

วิธีทำงานของแถว mapping

แต่ละแถวเชื่อมวิธีชำระเงินหนึ่งรายการกับ OPERA payment method code หนึ่งค่า AVA จะบันทึกแถวเหล่านี้ร่วมกับการตั้งค่าการชำระเงินอื่นของคุณ

ขั้นตอนที่ 5: ตั้งค่า Opera Payment Policy Controls (เฉพาะ Opera)

1. ใน Opera Payment Policy Controls ให้ตั้งค่าพฤติกรรมการชำระเงิน:
   • การแสดงใบแจ้งหนี้และการยืนยันก่อนเช็กเอาต์
   • การปัดเศษและ transaction code
   • ตัวเลือก auto delay capture
   • รายการกฎ waive / hide / no-collect
2. คลิก Save Payment Policies

สิ่งที่คาดว่าจะเห็นหลังบันทึก

• ✅ รายละเอียด gateway ที่เชื่อมต่อแล้วจะแสดงหลังตั้งค่า
• ✅ Stripe จะแสดง Live หรือ Test ในป้ายสถานะการเชื่อมต่อ
• ✅ ฟิลด์เงินมัดจำจะแสดงเมื่อเปิดใช้งานเงินมัดจำ
• ✅ สกุลเงินเงินมัดจำจะยังคงบันทึกไว้หลังคุณคลิก Save
• ✅ ส่วน Opera mapping และ Opera policy จะแสดงเฉพาะเมื่อใช้ Opera PMS
• ✅ การ์ด Step 3: Configure Opera PMS Payment Mapping จะแสดงเมื่อ active PMS provider เป็น Opera
• ✅ การตั้งค่าการชำระเงินแต่ละส่วนบันทึกแยกกันในหน้าเดียวกัน

หมายเหตุการย้ายเมนู

การตั้งค่าการชำระเงินถูกย้ายจาก Settings → Essentials มาอยู่ที่ Settings → Payment

การแก้ปัญหา

การตั้งค่า gateway ถูกปิดใช้งาน

สิ่งที่เห็น: toggle การชำระเงินหรือปุ่มบันทึกถูกปิด

วิธีแก้:

1. ยืนยันว่าบัญชีของคุณมีสิทธิ์เขียนการตั้งค่า
2. หากเลือก Stripe ให้เชื่อมต่อ Stripe ก่อน
3. รีเฟรชหน้าแล้วลองอีกครั้ง

ไม่เห็นส่วน Opera

สิ่งที่เห็น: ไม่เห็นการ์ด Opera mapping และ policy

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration
2. ยืนยันว่าผู้ให้บริการ PMS คือ Opera
3. กลับไปที่ Settings → Payment
4. รีเฟรชหน้า 1 ครั้ง
5. ตรวจว่าการ์ด Step 3: Configure Opera PMS Payment Mapping แสดงแล้ว

ผู้เข้าพักไม่ถูกขอให้ชำระเงิน

สิ่งที่เห็น: ผู้เข้าพักข้ามขั้นตอนชำระเงินระหว่างเช็กอิน

วิธีแก้:

1. ยืนยันว่าเชื่อมต่อเกตเวย์แล้ว
2. ยืนยันว่าเปิด Collect Security Deposits หรือ Collect Full Payment
3. ยืนยันว่าการจองยังมียอดค้างชำระ
4. บันทึกแล้วทดสอบกับการจองตัวอย่าง

สกุลเงินเงินมัดจำผิดหรือแก้ไม่ได้

สิ่งที่เห็น: สกุลเงินเงินมัดจำไม่ตรงตามที่คาด หรือเปลี่ยนค่าแล้วไม่คงอยู่

วิธีแก้:

1. เปิด Settings → Essentials → Hotel Basic Details
2. ตรวจว่า Property Currency เป็นแบบที่ PMS จัดการหรือแก้ไขได้
3. หาก PMS เป็นผู้จัดการสกุลเงิน ให้แก้ที่ PMS แล้วรอการซิงก์
4. รีเฟรช Settings → Payment แล้วตรวจสกุลเงินอีกครั้ง

การตั้งค่าที่เกี่ยวข้อง

• นโยบายการเช็กอิน
• การเชื่อมต่อ PMS
• การเชื่อมต่อ Opera PMS

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

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

• ❌ การชำระเงินยังล้มเหลวแม้บันทึกการตั้งค่าใหม่แล้ว
• ❌ ค่า Opera mapping ไม่คงอยู่
• ❌ การเชื่อมต่อ Stripe หรือ Red Dot หลุดซ้ำ ๆ

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

• ภาพหน้าจอ Settings → Payment
• ชื่อผู้ให้บริการ PMS
• ตัวอย่างรหัสการจองและเวลาที่เกิดปัญหา