การเชื่อมต่อ Payment Gateway

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

ตั้งค่า gateway ก่อน แล้วค่อยเลือกมุมมองบิลและกฎการชำระเงิน โรงแรมส่วนใหญ่ใช้เวลา 5 นาที

คู่มือนี้ช่วยให้คุณตั้งค่ากฎการชำระเงินและการแสดงผลบิลใน Settings → Payment ถ้าคุณใช้ Stripe ให้เลือก Live หรือ Test ก่อนเชื่อมต่อ การยกเว้น room payment จะตรวจ comment ของ reservation และ source labels เพื่อหา keyword แบบเดี่ยว ชื่อ travel-agent ของ Opera เช่น Booking.com (VCC) ก็สามารถทำให้เกิดการยกเว้นแบบเดียวกันได้ ตัวเลือก source แบบ OTA เดิมไม่ได้อยู่ในหน้านี้แล้ว

หาเมนูนี้ได้ที่ไหน

Settings → Payment

สรุปอ้างอิง

พื้นที่การตั้งค่า	ควบคุมอะไร	ผลลัพธ์หลัก
Billing View	สรุปบิลผู้เข้าพักแบบละเอียดหรือแบบย่อ	แสดงรายการแยกบรรทัดหรือสรุปสั้น ๆ
Payment Gateway Integration	การตั้งค่า Stripe หรือ Red Dot	ผู้เข้าพักจ่ายเงินได้ในโฟลว์คีออสก์
Stripe Environment	โหมด Live หรือ Test สำหรับการเชื่อม Stripe gateway และ terminal	ล็อกหลังเชื่อมต่อแล้ว
Payment Collection Mode	สวิตช์เก็บ deposit และชำระเต็มจำนวน	คุมว่าผู้เข้าพักจ่ายอะไรตอนเช็กอิน
Comment-Based Room Payment Waivers	keyword สำหรับยกเว้นใน reservation comments	ข้ามบล็อกยอดค้างเมื่อ PMS ของคุณรองรับการยกเว้นแบบ keyword
Property Currency (ใน Settings → Essentials)	สกุลเงินที่ใช้สำหรับ deposit และการแสดงผลการชำระเงินของ reservation	ทำให้จำนวนเงินสอดคล้องกันในทุกหน้าตั้งค่าและงานปฏิบัติการ
Deposit Currency	สกุลเงินที่ใช้กับยอด deposit ในหน้านี้	บันทึกไปพร้อมกับการตั้งค่าการชำระเงินอื่น ๆ
Opera Payment Mapping	การแมป settlement, cashier และ payment type	Opera ได้รับการโพสต์การชำระเงินถูกต้อง
Opera Payment Policy Controls	กฎ rounding, pre-auth, hide และ no-collect	บังคับพฤติกรรมการชำระเงินเฉพาะ Opera

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

• เตรียมบัญชี payment gateway ของคุณ
• ตัดสินใจว่าจะใช้มุมมองบิลแบบ Detailed หรือ Simplified
• ตัดสินใจว่าจะเก็บ deposit, ชำระเต็มจำนวน หรือทั้งสองอย่าง
• ยืนยันนโยบาย deposit และแหล่งที่มาของสกุลเงินที่พักใน Settings → Essentials → Hotel Basic Details
• ยืนยันว่ารุ่น PMS ของคุณรองรับ keyword สำหรับ payment waiver อย่างชัดเจน ถ้า AVA ยืนยันไม่ได้ ฟิลด์นี้จะถูกซ่อนไว้
• ถ้าใช้ Opera ให้เตรียม cashier ID และการแมป payment method code

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

ขั้นที่ 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 สำหรับ production และ Test สำหรับ sandbox onboarding หลัง Stripe เชื่อมต่อแล้ว environment จะเป็นแบบอ่านอย่างเดียวจนกว่าคุณจะ disconnect

การตั้งค่า Stripe สำหรับ terminal ก็จะ default เป็น Live เช่นกัน เว้นแต่คุณจะเปลี่ยนก่อนเชื่อมต่อ ::

การเช็กเอาต์ผ่าน terminal

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

สำหรับ Red Dot Payment

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

ขั้นที่ 2: เลือก Billing View

ใช้การ์ดนี้เพื่อควบคุมสรุปบิลที่ผู้เข้าพักเห็น เลือก Detailed สำหรับรายการแยกบรรทัด เลือก Simplified สำหรับ Room Charges, Tax, และยอดรวม

1. ไปที่ Settings → Payment
2. ใน Billing View เลือก Detailed หรือ Simplified
3. คลิก Save

ตำแหน่งของ billing view

การ์ดนี้จะแสดงก่อน Terminal Payment Configuration บนหน้าการชำระเงิน ::

ขั้นที่ 3: เลือกตัวเลือกการเก็บเงิน

สวิตช์	ทำอะไร
Collect Security Deposits	pre-authorize deposit ระหว่างเช็กอิน
Collect Full Payment	ให้ผู้เข้าพักจ่ายยอดคงค้างระหว่างเช็กอิน

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

ขั้นที่ 4: ตั้งรายละเอียด deposit (ถ้าเปิดใช้)

1. กรอก Deposit Amount
2. เลือก Deposit Type (ต่อคืนหรือจำนวนเงินคงที่)
3. ถ้าเห็น Deposit Currency ให้เลือกสกุลเงินที่โรงแรมใช้กับ deposit
4. คลิก Save Payment Gateway Settings

แหล่งของ deposit currency

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

การยกเว้น room payment จากคอมเมนต์

ใช้เมื่อ AVA ควรข้าม room payment จาก keyword waiver ที่ PMS รองรับ

• ตั้ง keyword waiver หนึ่งคำใน Payment Policy Controls
• AVA จะตรวจ reservation comments และ source labels เพื่อหา keyword นั้น
• Opera ยังส่งชื่อโปรไฟล์ travel-agent เข้า match เดียวกันนี้ด้วย
• ถ้า keyword ตรงแบบเป็นคำเดี่ยว AVA จะข้ามบล็อกการชำระเงิน
• ถ้ามันอยู่แค่ใน token ที่ยาวกว่า AVA จะยังถือว่ายอดนั้นต้องจ่าย
• ถ้าไม่ตรง AVA จะถือว่ายอดยังจ่ายได้อยู่

ป้ายแหล่งของ Opera

ถ้า Opera ส่งป้าย travel-agent กลับมา AVA จะอ่านค่าเช่น Booking.com (VCC) ได้ ป้ายนี้อาจตรงกับ keyword ที่ยกเว้นได้ ::

พฤติกรรม waiver แบบสากล

เมื่อ AVA ยืนยันการรองรับ keyword-waiver ไม่ได้ editor จะยังถูกซ่อนอยู่ Cloudbeds, eZee, Ava, Furama, vendor ที่ไม่รู้จัก และ PMS เวอร์ชันที่ไม่รองรับจะไม่แสดงฟิลด์นี้ ::

1. เปิด Payment Policy Controls
2. กรอก keyword waiver ที่ PMS ของคุณเขียนลงใน reservation comments
3. คลิก Save
4. ทดสอบด้วย reservation ที่มี keyword นั้น

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

1. ใน 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

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

ค่าเริ่มต้นของ Opera payment comment

AVA จะส่ง Default Comment Type / Location ที่คุณตั้งไว้เมื่อสร้าง Opera payment หรือ deposit comment บันทึก mapping อีกครั้งหลังเปลี่ยนค่านี้ ::

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

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

คอมเมนต์การชำระเงินของ Opera

AVA จะพยายามเพิ่ม reservation comment ของ Opera ก่อนโพสต์ payment หรือ deposit ถ้าสร้าง comment ไม่สำเร็จ AVA จะยังโพสต์ payment หรือ deposit ใน Streamliner ต่อ วิธีนี้ช่วยให้การเก็บเงินเดินหน้าต่อได้แม้สร้าง Opera comment ไม่สำเร็จ keyword waiver แบบสากลตั้งค่าไว้ด้านบน ::

ควรเห็นอะไรหลังบันทึก

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

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

การตั้งค่าการชำระเงินย้ายจาก Settings → Essentials ไปที่ Settings → Payment แล้ว ตัวเลือก OTA source แบบเก่าถูกนำออก ::

การแก้ปัญหา

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

สิ่งที่เห็น: สวิตช์การชำระเงินหรือปุ่มบันทึกเป็นสีเทา

วิธีแก้:

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

Billing view ไม่เปลี่ยน

สิ่งที่เห็น: ผู้เข้าพักยังเห็นเลย์เอาต์สรุปบิลแบบเดิม

วิธีแก้:

1. กลับไปที่ Settings → Payment
2. เลือก Detailed หรือ Simplified ใหม่
3. คลิก Save ที่การ์ด Billing View
4. เริ่มโฟลว์ผู้เข้าพักใหม่หรือรีเฟรชหน้าจอ reservation
5. ถ้ายังผิด ให้ยืนยันว่าโรงแรมอยู่บนเส้นทางการตั้งค่า CCI ปัจจุบัน

Stripe environment ถูกล็อก

สิ่งที่เห็น: dropdown Environment ถูกปิดใช้งานหลัง Stripe เชื่อมต่อแล้ว

วิธีแก้:

1. Disconnect Stripe
2. เปิด Advanced
3. เลือก Live หรือ Test
4. เชื่อม Stripe ใหม่

ส่วนของ Opera ไม่แสดง

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

วิธีแก้:

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

Opera payment mappings บันทึกไม่อยู่

สิ่งที่เห็น: แถว cashier หรือ payment method หายไปหลังคลิก Save

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration
2. ยืนยันว่า Opera ยังเป็น PMS ที่ active อยู่
3. กลับไปที่ Settings → Payment
4. กรอก Default Cashier ID และแต่ละแถว mapping ใหม่
5. คลิก Save Opera Payment Mapping อีกครั้ง

reservation comment ของ Opera หายไป

สิ่งที่เห็น: payment โพสต์สำเร็จ แต่ไม่เห็น reservation comment ใหม่ใน Opera

วิธีแก้:

1. ยืนยันว่า payment หรือ deposit เสร็จใน Streamliner แล้ว
2. ตรวจว่า Opera reservation มี payment record ที่ตรงกัน
3. ยืนยันว่า Default Comment Type / Location ตั้งค่าไว้ใน Opera PMS Payment Mapping
4. อย่าลองซ้ำเพียงเพื่อสร้าง comment ใหม่
5. ติดต่อซัพพอร์ตหาก payment โพสต์แล้วแต่ comment ยังไม่ปรากฏ

Comment type หรือ location ของ Opera ดูผิด

สิ่งที่เห็น: Opera สร้าง payment comment แต่ type หรือ location ดูไม่คาดคิด

วิธีแก้:

1. เปิด Settings → Payment
2. ตรวจ Opera PMS Payment Mapping
3. ยืนยัน Default Comment Type / Location
4. บันทึก mapping อีกครั้ง
5. ทดสอบ Opera payment หรือ deposit อื่น

room payment ถูกยกเว้นโดยไม่คาดคิด

สิ่งที่เห็น: reservation ข้าม room payment ทั้งที่คุณคาดว่าจะมีคำขอชำระเงิน

วิธีแก้:

1. เปิด reservation ใน PMS
2. ตรวจ reservation comment, source name และ Opera travel-agent label
3. ลบหรือเปลี่ยน keyword หาก reservation นี้ไม่ควรถูกยกเว้น
4. รีเฟรช AVA แล้วทดสอบอีกครั้งด้วย reservation ใหม่

ฟิลด์ keyword ยกเว้นการชำระเงินหายไป

สิ่งที่เห็น: คุณไม่เห็นฟิลด์ keyword ยกเว้น หรือเห็นข้อความ PMS ที่ไม่รองรับใน Payment Policy Controls

วิธีแก้:

1. ยืนยันว่า PMS provider ของคุณรองรับ keyword waiver
2. รีเฟรช Settings → Payment
3. ถ้าฟิลด์ยังไม่แสดง แปลว่า AVA ยังไม่มีข้อมูลรองรับของ PMS นั้น
4. เก็บ keyword ยกเว้นที่มีอยู่ไว้ AVA ยังบันทึกไว้แม้ editor จะถูกซ่อน

ผู้เข้าพักไม่ถูกขอให้จ่าย

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

วิธีแก้:

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

สกุลเงิน deposit ดูผิดหรือแก้ไม่ได้

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

วิธีแก้:

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

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

• Check-In Policy
• PMS Connection
• Opera PMS Integration

ยังติดอยู่?

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

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

ข้อมูลที่ช่วยได้:

• ภาพหน้าจอของ Settings → Payment
• ชื่อผู้ให้บริการ PMS
• ตัวอย่าง reservation ID และเวลาเกิดเหตุ