การเชื่อมต่อเกตเวย์การชำระเงิน

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

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

คู่มือนี้ช่วยให้คุณตั้งค่ากฎการชำระเงินและการเรียกเก็บเงินใน Settings → Payment หากใช้ Stripe ให้เลือก Live หรือ Test ก่อนเชื่อมต่อ ข้อมูลรับรอง Stripe ของ gateway จะอยู่บนการ์ดการชำระเงิน ข้อมูลรับรองแบบ manual ของ terminal จะอยู่บนการ์ดการตั้งค่า terminal และใช้ test keys เท่านั้น หากโรงแรมใช้ข้อมูลรับรอง Stripe test แบบ manual การ์ด gateway และ terminal จะบันทึกข้อมูลแยกกัน ใช้ Stripe test keys สำหรับการ์ดแต่ละใบที่คุณตั้งค่า นโยบายค่าใช้จ่ายที่พักต้องตรงกับค่าที่ PMS ส่งมา ชื่อ travel-agent ของ Opera เช่น Booking.com (VCC) ก็สามารถทำให้เกิด waiver ที่ตรงกันได้ สำหรับ waiver ของ room-package ใน Opera AVA จะ waive room charge, room service charge และ room GST ก่อน สำหรับ projection ของ Opera ก่อนเข้าพัก projected room charge และภาษี rate-info ของรายการนั้นจะถูก waive พร้อมกัน รายการเสริมที่โพสต์แยกต่างหากและภาษีของรายการเหล่านั้นยังต้องชำระ สำหรับ Mews ผลิตภัณฑ์ที่ตรวจสอบแล้วและรวมอยู่ใน rate ที่ตรงกัน เช่น อาหารเช้าแบบ bundled อาจทำตาม accommodation waiver ได้ หลังจาก waiver นั้น AVA จะซ่อนยอดคงเหลือ THB 0.01 ที่เป็นบวกเฉพาะเมื่อเป็นเศษจากการปัดเศษของค่าใช้จ่ายที่พัก รายการเสริมจริงและค่าใช้จ่ายที่ยังจัดประเภทไม่ได้ยังต้องชำระ รวมถึงรายการเสริมจริงจำนวน THB 0.01 ตัวเลือก source แบบ OTA เดิมไม่ได้เป็นส่วนหนึ่งของหน้านี้แล้ว

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

Settings → Payment

สรุปอ้างอิง

พื้นที่การตั้งค่า	ควบคุมอะไร	ผลลัพธ์หลัก
Billing View	สรุปบิลผู้เข้าพักแบบละเอียดหรือแบบย่อ	แสดงรายการแยกบรรทัดหรือสรุปสั้น ๆ
Payment Gateway Integration	การตั้งค่า Stripe หรือ Red Dot	ผู้เข้าพักสามารถชำระเงินในโฟลว์คีออสก์ได้
Stripe Environment	โหมด Live หรือ Test สำหรับการเชื่อมต่อ gateway และ terminal ของ Stripe	ล็อกหลังเชื่อมต่อแล้ว
Manual Stripe Test Credentials	Stripe keys สำหรับ test เท่านั้นบนการ์ด gateway และ terminal	บันทึกการตั้งค่า Stripe ของ gateway และ terminal แยกกัน
Terminal Payment Configuration	terminal API key, publishable key และ webhook secret ของ Stripe	บันทึกข้อมูลรับรอง terminal แยกจาก Stripe gateway
Payment Collection Mode	สวิตช์เก็บเงินมัดจำและชำระเต็มจำนวน	ควบคุมว่าผู้เข้าพักจ่ายอะไรตอนเช็กอิน
Accommodation Charge Policies	ค่าที่ตรงกันซึ่งใช้ waive หรือซ่อนค่าใช้จ่ายที่พัก	ควบคุมแถวค่าใช้จ่ายที่พักและยอดที่ต้องชำระเมื่อ PMS รองรับความสามารถนี้
AVA Billing Rules	สัญญาณ hide และ waive จาก PMS สำหรับแถวห้อง ภาษี มัดจำ และค่าใช้จ่ายเบ็ดเตล็ด	แสดงแถวที่ซ่อนเป็น ✅ รักษายอดที่ต้องชำระให้เป็นตัวเลข และคงรายการเสริมที่ต้องชำระไว้
Property Currency (ใน Settings → Essentials)	สกุลเงินที่ resolved แล้วสำหรับการแสดงยอดมัดจำและการชำระเงินของ reservation	ทำให้จำนวนเงินสอดคล้องกันในทุกหน้าตั้งค่าและการปฏิบัติงาน
Deposit Currency	สกุลเงินที่ใช้กับยอดมัดจำในหน้านี้	บันทึกไปพร้อมกับการตั้งค่าการชำระเงินอื่น ๆ
Opera Payment Mapping	การแมป settlement, cashier และ payment type	PMS ได้รับการโพสต์การชำระเงินถูกต้อง
Checkout Rounding Adjustment	ค่าเผื่อยอดเล็กน้อยและการปรับยอดตอนเช็กเอาต์	PMS ที่รองรับสามารถเช็กเอาต์ได้แม้ยังมียอดเล็กน้อย
Pre-Authorization Controls	การเรียกเก็บ room rate ล่าช้าจาก Stripe pre-authorizations	แสดงเมื่อ PMS ที่ใช้งานอยู่รองรับการเรียกเก็บล่าช้า
Opera-Specific Payment Controls	การยืนยันตอนเช็กเอาต์ การ routing และตรรกะ no-collect	บังคับใช้พฤติกรรมการชำระเงินเฉพาะ Opera

การพึ่งพาการปัดเศษ

Rounding adjustment จะทำงานก็ต่อเมื่อเปิด Check-in outstanding-balance blocking หรือ Checkout balance settlement ใน Check-In Policy หากปิดทั้งสองรายการ AVA จะเก็บค่า rounding ที่บันทึกไว้ แต่การควบคุมจะยังไม่ทำงาน AVA จะแสดงการควบคุมนี้เฉพาะเมื่อ PMS ที่ใช้งานอยู่รายงานว่ารองรับ checkout-rounding หากข้อมูลความสามารถหายไปหรือมีรูปแบบไม่ถูกต้อง การควบคุมจะถูกซ่อนไว้

การควบคุมตามความสามารถ

AVA อ่านการรองรับ checkout-rounding จากความสามารถของ PMS ที่ใช้งานอยู่ จะแสดง Transaction Code (Rounding) เฉพาะเมื่อความสามารถนั้นประกาศว่ามีฟิลด์ vendor-code ความสามารถของ PMS ที่ไม่รองรับหรือยังไม่ยืนยันจะไม่ส่งการตั้งค่า rounding ใหม่

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

• เตรียมบัญชี payment gateway ของคุณ
• ตัดสินใจว่าจะใช้มุมมองบิลแบบ Detailed หรือ Simplified
• ตัดสินใจว่าจะเก็บเงินมัดจำ ชำระเต็มจำนวน หรือทั้งสองอย่าง
• ยืนยันนโยบายมัดจำและแหล่งสกุลเงินของที่พักใน Settings → Essentials → Hotel Basic Details
• ยืนยันว่า PMS ของคุณเปิดเผยความสามารถด้าน accommodation payment-policy หาก AVA ยืนยันการรองรับไม่ได้ การควบคุมจะถูกซ่อนไว้
• ยืนยันว่า PMS ของคุณเปิดเผยการรองรับ delayed pre-authorization capture หากต้องการใช้ Auto Delay Capture
• หากใช้ Opera กฎการเรียกเก็บเงินของ AVA จะพร้อมใช้งานที่นั่นก่อน
• หาก PMS รองรับ payment mapping ให้เตรียม 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 เช่นกัน เว้นแต่คุณจะเปลี่ยนก่อนเชื่อมต่อ

ข้อมูลรับรอง Stripe Test แบบ Manual

ใช้ส่วนนี้เมื่อโรงแรมของคุณเปิดใช้ฟิลด์ข้อมูลรับรอง Stripe test แบบ manual

1. เปิดการ์ด Stripe ที่ต้องการแก้ไข
2. กรอก Publishable Key, Secret Key และ Webhook Secret
3. ใช้ keys สำหรับ test เท่านั้นกับการ์ดนั้น
4. คลิก Save
5. หากภายหลังฟิลด์ถูก mask ให้คลิก Save อีกครั้งโดยไม่ต้องกรอกค่าใหม่

การ์ด Stripe แยกกัน

ข้อมูลรับรอง Stripe ของ gateway จะบันทึกบนการ์ด payment gateway ข้อมูลรับรอง Stripe ของ terminal จะบันทึกบนการ์ดการตั้งค่า terminal เก็บ gateway keys และ terminal keys แยกกัน

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

เมื่อคีออสก์มี Stripe terminal ที่แมปไว้เพียงเครื่องเดียว AVA จะเปิด terminal นั้นโดยอัตโนมัติระหว่างเช็กเอาต์ เมื่อมี terminal ที่แมปไว้มากกว่าหนึ่งเครื่อง คุณจะเลือกจาก terminal picker ใน payment modal หากปิดโหมด terminal AVA จะใช้โฟลว์การชำระเงินผ่าน gateway หรือ QR ต่อไป หากคีออสก์ใช้ข้อมูลรับรอง Stripe Terminal โดยตรง AVA ยังเริ่มเช็กเอาต์ได้แม้ Stripe Account ID จะว่าง เมื่อมีทั้งข้อมูลรับรองโดยตรงและ Connect account AVA จะคงพฤติกรรมของ Connect account ไว้ ข้อมูลรับรองแบบ manual ของ terminal แยกจากข้อมูลรับรอง Stripe ของ gateway ใช้ข้อมูลเหล่านี้กับ test terminals เท่านั้น หากฟิลด์ถูก mask คุณสามารถบันทึกอีกครั้งโดยไม่ต้องกรอกค่าใหม่

สำหรับ 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 เงินมัดจำระหว่างเช็กอิน
Collect Full Payment	ให้ผู้เข้าพักชำระยอดคงค้างระหว่างเช็กอิน

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

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

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

แหล่งที่มาของ deposit currency

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

ตั้งค่านโยบายค่าใช้จ่ายที่พัก

ใช้การควบคุมเหล่านี้เมื่อ PMS ของคุณรองรับนโยบายการชำระเงินค่าที่พัก การควบคุมจะแสดงใต้ Payment Policy Controls ใน Settings → Payment

การควบคุม	ทำอะไร
Waive Accommodation Charges	ไม่เรียกเก็บค่าใช้จ่ายที่พัก ภาษีที่เกี่ยวข้อง หรือค่าบริการ แถวยังคงมองเห็นได้
Hide and Waive Accommodation Charges	ซ่อนและไม่เรียกเก็บค่าใช้จ่ายที่พัก ภาษีที่เกี่ยวข้อง หรือค่าบริการ

รายการเสริมที่โพสต์แยกต่างหากและภาษีของรายการเหล่านั้นยังมองเห็นและต้องชำระได้ภายใต้นโยบายทั้งสองแบบ หากนโยบายทั้งสองตรงกัน นโยบาย hide จะเปลี่ยนเฉพาะการมองเห็น ยอดที่ต้องชำระยังคงเท่าเดิม

1. ไปที่ Settings → Payment
2. ค้นหา Payment Policy Controls → Accommodation Charge Policies
3. เพิ่มค่าที่ตรงกันแต่ละค่าจาก PMS ลงในรายการที่เหมาะสม
4. คลิก Save Payment Policies
5. ทดสอบ reservation ที่ตรงกับค่าที่ตั้งไว้

การแสดงผลตามความสามารถ

AVA จะแสดงการควบคุมเหล่านี้เฉพาะเมื่อ PMS ที่ใช้งานอยู่เปิดเผยความสามารถที่จำเป็น ค่าที่มีอยู่จะยังถูกเก็บไว้เมื่อการควบคุมไม่พร้อมใช้งานชั่วคราว

ป้าย source ของ Opera

หาก Opera ส่งป้าย travel-agent กลับมา AVA สามารถจับคู่ค่าอย่าง Booking.com (VCC) ได้

AVA Billing Rules

ใช้ส่วนนี้เมื่อ PMS ส่งสัญญาณ hide หรือ waive สำหรับแถวห้อง ภาษี มัดจำ หรือค่าใช้จ่ายเบ็ดเตล็ด

• Mews และ Opera รองรับกฎเหล่านี้เมื่อความสามารถของการเชื่อมต่ออนุญาต
• แถวห้องหรือภาษีที่ซ่อนจะแสดงเป็น ✅ ใน billing แบบละเอียด
• แถวห้องหรือภาษีที่ waive จะยังมองเห็นได้เมื่อ provider ส่งแถวเหล่านั้นกลับมา
• นโยบาย waive ของ Mews v2 สามารถล้างแถวค่าใช้จ่ายทั้งหมดของ invoice ได้
• ผลิตภัณฑ์ของ Mews ที่ตรวจสอบแล้วและรวมอยู่ใน rate เช่น อาหารเช้าแบบ bundled สามารถทำตาม waiver ของ room-package ได้
• ค่าบริการที่คำนวณโดยอิงกับผลิตภัณฑ์ที่รวมอยู่และตรวจสอบแล้วสามารถทำตาม waiver นั้นได้
• ยอด Mews ที่เป็นบวกไม่เกิน THB 0.01 จะถูกซ่อนเฉพาะเมื่อเป็นเศษจากการปัดเศษของค่าใช้จ่ายที่พักหลัง waiver
• ค่าใช้จ่ายที่จัดประเภทไม่ได้และรายการเสริมจริงที่เป็นบวกยังต้องชำระ รวมถึงรายการเสริมจริงจำนวน THB 0.01
• สำหรับ waiver ของ room-package ใน Opera AVA จะ waive room charge, room service charge และ room GST ก่อน
• projected room charges ของ Opera ก่อนเข้าพักและภาษี rate-info ของรายการเหล่านั้นจะถูก waive พร้อมกัน
• รายการเสริมของ Opera ที่โพสต์แยกต่างหากและภาษีของรายการเหล่านั้นอาจยังต้องชำระ
• แถวมัดจำหรือค่าใช้จ่ายเบ็ดเตล็ดที่ waive จะถูกนำออกจากยอดที่ต้องชำระ
• ยอดที่ต้องชำระหลังการประเมินจะควบคุมยอดคงเหลือที่แสดงและเรียกเก็บตอนเช็กเอาต์
• หากไม่มีการประเมิน billing ด้วยเหตุผลอื่น AVA อาจใช้สรุปจาก PMS หรือ snapshot ที่เก็บไว้
• waiver ของ Mews ที่สรุปไม่ได้จะไม่ใช้ยอดที่ยังไม่ตรวจสอบ พนักงานต้องตรวจ invoice ทั้งหมด
• เมื่อเปิดการเก็บเงินค่าห้อง AVA อาจส่งผู้เข้าพักไปที่ front desk ระหว่างค้นหา reservation
• หาก AVA พิสูจน์การจัดประเภทผลิตภัณฑ์ไม่ได้ จะกันยอดที่ยังไม่ตรวจสอบไว้ให้พนักงานตรวจสอบ
• ยอดศูนย์ที่ Opera ระบุอย่างชัดเจนจะยังเป็นศูนย์ แม้รายการห้อง ภาษี หรือบริการที่มองเห็นจะดูเป็นบวก ใช้กับกรณีที่ไม่เห็นรายการ counterpart ที่ถูก route หรือ settled AVA จะเชื่อถือยอดศูนย์นั้นเฉพาะเมื่อจำนวนเงินและสกุลเงินตรงกับบิล Opera ที่ normalize แล้ว หากไม่ตรงกันจะถือว่ายังไม่ยืนยัน
• billing แบบย่อจะแสดงแถวห้องและภาษีที่ซ่อน ตัวคั่น Extras และจัดกลุ่มรายการเสริมตาม code
• แถว billing ที่เป็น projection อาจยังมองเห็นได้ขณะที่ PMS กำลัง sync
• เปรียบเทียบยอดที่ไม่คาดคิดกับ PMS ก่อนเรียกเก็บเงิน
• เมื่อไม่มีนโยบายใดตรงกัน AVA จะใช้ billing response ที่ได้รับ

การเปิดใช้ตามความสามารถ

หาก PMS ของคุณไม่รองรับกฎการเรียกเก็บเงินของ AVA AVA จะคงสรุปการชำระเงินแบบปกติไว้

1. เปิด reservation ที่ใช้กฎ billing ของ PMS
2. รีเฟรช reservation ใน AVA
3. เปรียบเทียบแถวที่มองเห็นกับยอดที่ต้องชำระ
4. ทดสอบอีกครั้งหลัง PMS sync เสร็จ

ขั้นที่ 5: ตั้งค่า PMS Payment Mapping (เมื่อรองรับ)

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 หนึ่งรายการกับ PMS payment method code หนึ่งรายการ AVA จะบันทึกแถวเหล่านี้พร้อมกับการตั้งค่าการชำระเงินอื่น ๆ

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

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

ความพร้อมใช้งานตามความสามารถ

ส่วน mapping อาจยังใช้ถ้อยคำเฉพาะของ Opera การแสดงผลขึ้นอยู่กับความสามารถด้าน payment-mapping จากการเชื่อมต่อ PMS ที่ใช้งานอยู่

ขั้นที่ 6: ตั้งค่า Checkout Rounding Adjustment

AVA จะแสดงการควบคุมนี้ใต้ Payment Policy Controls เมื่อ PMS ของคุณรองรับ

ผู้ให้บริการ PMS	การรองรับ	การตั้งค่าเพิ่มเติม
AVA	รองรับ	ไม่ต้องใช้ vendor code
Opera / OHIP	รองรับ	บันทึก vendor code ใน Transaction Code (Rounding)
Cloudbeds, Mews, eZee และ Furama	ไม่รองรับ	การควบคุมจะถูกซ่อนไว้

1. ไปที่ Settings → Check-In → Check-In Policy

2. เปิด Check-in outstanding-balance blocking หรือ Checkout balance settlement

3. ไปที่ Settings → Payment

4. ค้นหา Payment Policy Controls

5. เปิด Enable Rounding Adjustment

6. ตั้งค่า Rounding Threshold ในสกุลเงินเริ่มต้นของที่พัก

7. หากใช้ Opera ให้กรอก vendor code ใน Transaction Code (Rounding)

8. คลิก Save Payment Policies

   ✓ AVA จะใช้การปรับยอดตอนเช็กเอาต์เมื่อยอดคงเหลืออยู่ภายใน threshold ของคุณ

การทำงานของการปรับยอด

ระหว่างเช็กอิน AVA ยอมรับยอดคงเหลือที่อยู่ภายใน threshold ที่ตั้งไว้โดยไม่โพสต์ transaction ระหว่างเช็กเอาต์ AVA จะโพสต์ rounding adjustment ก่อนทำเช็กเอาต์ให้เสร็จ AVA ไม่ใช้ vendor code ส่วน Opera ใช้ vendor code ที่ตั้งค่าไว้

ขั้นที่ 7: ตั้งค่า Auto Delay Capture

ใช้ Auto Delay Capture เมื่อ PMS ของคุณรองรับ delayed capture AVA จะ capture room rate ก่อน Stripe pre-authorization หมดอายุ เงินมัดจำจะยังไม่ถูก capture

การตั้งค่า	ทำอะไร
Enable Auto Delay Capture	capture room rate โดยอัตโนมัติก่อน pre-authorization หมดอายุ
Auto Delay Capture Expiry Days	กำหนดจำนวนวันก่อนหมดอายุที่ AVA จะ capture room rate

1. ไปที่ Settings → Payment

2. ค้นหา Payment Policy Controls → Pre-Authorization Controls

3. เปิด Enable Auto Delay Capture

4. กรอก Auto Delay Capture Expiry Days

5. คลิก Save Payment Policies

   ✓ AVA จะ capture room rate ก่อนหมดอายุเมื่อ pre-authorization ยังใช้ได้

การแสดงผลตามความสามารถ

AVA จะแสดงการควบคุมเหล่านี้เฉพาะเมื่อ PMS ที่ใช้งานอยู่รายงานว่ารองรับ delayed capture ปัจจุบัน Opera รายงานว่ารองรับ PMS อื่นจะแสดงการควบคุมก็ต่อเมื่อรายงานความสามารถเดียวกัน

การเปลี่ยน PMS อาจล้างการตั้งค่านี้

หากเปลี่ยนไปใช้ PMS ที่ไม่รองรับ delayed capture AVA จะปิด Auto Delay Capture AVA จะล้างค่า expiry-day ด้วยเพื่อป้องกันการนำการตั้งค่าเก่ามาใช้

ขั้นที่ 8: ตั้งค่าการควบคุมการชำระเงินเฉพาะ Opera (เฉพาะ Opera)

1. ไปที่ Settings → Payment

2. ค้นหา Opera-Specific Payment Controls

3. ตั้งค่าพฤติกรรมการชำระเงิน:

   • การเข้าถึง invoice ของ in-house และการยืนยันวันเกิดสำหรับเช็กเอาต์
   • พฤติกรรม Ignore Waive Payment Routing

4. ใน Do Not Collect Any Incidental / Deposit ให้เพิ่ม rate code, market segment, guarantee type หรือ comment ที่ตรงกันแต่ละรายการ

5. คลิก Save Payment Policies

   ✓ แถวค่าใช้จ่ายเบ็ดเตล็ดหรือมัดจำที่ตรงกันจะถูกนำออกจากยอดที่ต้องชำระ

Opera payment comments

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

การพึ่งพาของ Rounding Adjustment

ใช้ส่วนนี้เมื่อต้องการให้ rounding ตอนเช็กเอาต์มีผลต่อพฤติกรรมการชำระเงิน

1. ไปที่ Settings → Check-In → Check-In Policy

2. เปิด Check-in outstanding-balance blocking หรือ Checkout balance settlement

3. กลับไปที่ Settings → Payment

4. เปิด Payment Policy Controls และตั้งค่า Enable Rounding Adjustment

   ✓ AVA จะใช้การตั้งค่า rounding เฉพาะเมื่อเปิดนโยบายใดนโยบายหนึ่ง

ค่าที่บันทึกไว้ยังคงอยู่

หากภายหลังปิดนโยบายยอดคงเหลือตอนเช็กอินทั้งสองรายการ AVA จะเก็บค่า rounding ที่บันทึกไว้ การควบคุมจะหยุดส่งผลต่อพฤติกรรมการชำระเงินเท่านั้น

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

• ✅ รายละเอียด gateway ที่เชื่อมต่อแล้วจะแสดงหลังตั้งค่า
• ✅ Stripe จะแสดง Live หรือ Test ในป้ายสถานะการเชื่อมต่อ
• ✅ Billing view จะบันทึกไปพร้อมกับการตั้งค่าการชำระเงินอื่น ๆ
• ✅ ฟิลด์มัดจำจะแสดงเมื่อเปิดใช้การเก็บเงินมัดจำ
• ✅ Deposit currency จะยังคงถูกบันทึกหลังคลิก Save
• ✅ Auto Delay Capture จะแสดงเฉพาะเมื่อ PMS ที่ใช้งานอยู่รองรับ
• ✅ PMS payment mapping จะแสดงเมื่อ PMS ที่ใช้งานอยู่รายงานว่ารองรับ
• ✅ ส่วน policy ของ Opera จะแสดงเฉพาะสำหรับ Opera PMS
• ✅ การ์ด payment mapping อาจแสดงสำหรับ PMS ที่ไม่ใช่ Opera เมื่อการเชื่อมต่อรายงานว่ารองรับ
• ✅ การตั้งค่าการชำระเงินจะบันทึกแยกกันได้บนหน้าเดียวกัน

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

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

การแก้ปัญหา

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

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

วิธีแก้:

1. ยืนยันว่าบัญชีของคุณมีสิทธิ์เขียน settings
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 อีกครั้ง

ข้อมูลรับรอง Stripe terminal ถูกปฏิเสธ

สิ่งที่เห็น: ข้อมูลรับรอง Stripe ของ gateway หรือ terminal ไม่ถูกบันทึก หรือ AVA ล้างข้อมูลหลังบันทึก

วิธีแก้:

1. ยืนยันว่ากำลังแก้ไขการ์ด Stripe ที่ถูกต้อง
2. ข้อมูลรับรองของ gateway และ terminal จะบันทึกแยกกัน
3. ใช้ค่าสำหรับ test เท่านั้นเมื่อตั้งค่า Stripe แบบ manual
4. ตรวจสอบว่า secret key ขึ้นต้นด้วย sk_test_
5. ตรวจสอบว่า publishable key ขึ้นต้นด้วย pk_test_
6. บันทึกการตั้งค่าอีกครั้ง
7. หากฟิลด์ถูก mask ให้บันทึกอีกครั้งโดยไม่ต้องกรอกค่าใหม่

ไม่แสดงข้อมูลรับรอง Stripe test

สิ่งที่เห็น: ฟิลด์ Stripe แบบ manual หายไปจากการ์ด gateway หรือ terminal

วิธีแก้:

1. รีเฟรช Settings → Payment
2. ยืนยันว่าโรงแรมของคุณอยู่ใน rollout ข้อมูลรับรอง Stripe test แบบ manual
3. ติดต่อ support หากฟิลด์ยังไม่แสดง

ไม่แสดงการควบคุม payment policy

สิ่งที่เห็น: การควบคุม accommodation, checkout rounding, delayed capture หรือการชำระเงินเฉพาะ Opera หายไป

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration
2. ยืนยันว่า PMS ที่ใช้งานอยู่ถูกต้อง
3. กลับไปที่ Settings → Payment
4. รีเฟรชหน้าหนึ่งครั้ง
5. ขอให้ผู้ดูแลระบบยืนยันว่าเปิดใช้ความสามารถของ PMS แล้ว

PMS payment mapping

Payment mapping จะแสดงเมื่อ PMS ที่ใช้งานอยู่รายงานว่ารองรับ ปัจจุบัน Opera รายงานว่ารองรับความสามารถนี้ ส่วน mapping แยกจากการควบคุม payment policy อื่น ๆ ที่กำหนดตามความสามารถ

ไม่พบ Auto Delay Capture

สิ่งที่เห็น: Pre-Authorization Controls ไม่แสดง Auto Delay Capture

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration
2. ยืนยันว่า PMS ที่ถูกต้องกำลังใช้งานอยู่
3. รีเฟรช Settings → Payment หลังเปลี่ยนการเชื่อมต่อ PMS
4. สอบถามผู้ดูแลระบบหรือ Vouch support ว่า PMS รายงานการรองรับ delayed capture หรือไม่

หาก PMS ไม่รายงานการรองรับ การควบคุมจะยังถูกซ่อนไว้ นี่เป็นพฤติกรรมที่คาดไว้

การตั้งค่า Auto Delay Capture ถูกปฏิเสธ

สิ่งที่เห็น: AVA แจ้งว่า delayed capture ไม่พร้อมใช้งานเมื่อบันทึกการตั้งค่าการชำระเงิน

วิธีแก้:

1. ยืนยันว่า PMS ที่ใช้งานอยู่รองรับ delayed capture
2. ปิด Auto Delay Capture หากเปลี่ยนผู้ให้บริการ PMS
3. บันทึกการตั้งค่าการชำระเงิน
4. ลองอีกครั้งหลังความสามารถของ PMS พร้อมใช้งาน

AVA จะไม่บันทึกการตั้งค่า delayed capture สำหรับ PMS ที่ไม่รองรับหรือยังไม่ยืนยัน

PMS payment mapping ไม่ถูกบันทึก

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

วิธีแก้:

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

สกุลเงินของ Opera payment ไม่ตรงกัน

สิ่งที่เห็น: Opera แสดง internal error หรือ payment หรือ deposit ไม่ปรากฏหลังโพสต์

วิธีแก้:

1. ตรวจสอบ Property Currency ใน Settings → Essentials → Hotel Basic Details
2. ตรวจสอบว่า reservation ของ Opera ใช้สกุลเงินเดียวกัน
3. ลอง payment หรือ deposit อีกครั้ง
4. ติดต่อ support หาก Opera ยังแสดง internal error

Opera reservation comment หายไป

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

วิธีแก้:

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

ประเภทหรือ location ของ Opera comment ไม่ถูกต้อง

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

วิธีแก้:

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

Room payment ถูก waive โดยไม่คาดคิด

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

วิธีแก้:

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

การควบคุมนโยบายที่พักไม่พร้อมใช้งาน

สิ่งที่เห็น: ไม่เห็น Accommodation Charge Policies หรือ AVA แสดงข้อความว่า PMS ไม่รองรับ

วิธีแก้:

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

แถว billing ไม่ตรงกับ PMS

สิ่งที่เห็น: แถวห้อง ภาษี มัดจำ หรือค่าใช้จ่ายเบ็ดเตล็ดดูแตกต่างกันใน AVA

วิธีแก้:

1. ยืนยันว่า reservation มาจาก PMS ที่รองรับ AVA Billing Rules
2. หากใช้ Opera ให้รอ reservation sync ครั้งถัดไป
3. รีเฟรช Settings → Payment หรือเปิด reservation อีกครั้ง
4. ตรวจสอบบิลใน PMS เพื่อยืนยันว่าแถวนั้นถูกซ่อนหรือ waive

ผลิตภัณฑ์ที่รวมใน Mews ต้องตรวจสอบ

สิ่งที่เห็น: ผลิตภัณฑ์แบบ bundled ของ Mews ต้องตรวจสอบหลังมี waiver ของ room-package ที่ตรงกัน

สาเหตุ: AVA ไม่สามารถพิสูจน์การจัดประเภทของผลิตภัณฑ์ได้

วิธีแก้:

1. เปิด reservation ผ่าน Staff Access
2. ตรวจสอบ rate, ผลิตภัณฑ์ที่รวมอยู่ และ invoice ทั้งหมดใน Mews
3. ยืนยันว่า reservation ตรงกับนโยบายค่าใช้จ่ายที่พักที่ตั้งไว้
4. รีเฟรช reservation ใน AVA
5. อย่าเรียกเก็บยอดที่ยังไม่ยืนยัน
6. ขอให้พนักงาน front desk ตรวจสอบ invoice ทั้งหมดของ Mews

ผู้เข้าพักถูกส่งไปที่ front desk ก่อนชำระเงิน

สิ่งที่เห็น: ผู้เข้าพักไปต่อไม่ได้หลังค้นหา reservation และ AVA ขอให้ไปพบ front desk

สาเหตุ: มีนโยบายการชำระเงินตรงกัน แต่ Mews ไม่สามารถจัดประเภทค่าใช้จ่ายที่อยู่ภายใต้กฎได้

วิธีแก้:

1. ตรวจสอบ rate, ผลิตภัณฑ์ที่รวมอยู่ และ invoice ทั้งหมดใน Mews
2. ยืนยันค่าที่ตรงกันใน Accommodation Charge Policies
3. รีเฟรช reservation หลัง Mews sync เสร็จ
4. ยืนยันยอดที่ต้องชำระกับ invoice ทั้งหมดของ Mews
5. ขอให้พนักงาน front desk ดำเนินการเช็กอินเมื่อยังจำเป็นต้องตรวจสอบ

อย่าเรียกเก็บยอดที่ยังไม่ยืนยัน

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

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

วิธีแก้:

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

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

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

วิธีแก้:

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

Checkout rounding ไม่พร้อมใช้งาน

สิ่งที่เห็น: ไม่แสดง Enable Rounding Adjustment

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration
2. ยืนยัน provider ของ PMS ที่ใช้งานอยู่
3. AVA และ Opera รองรับ checkout rounding
4. Cloudbeds, Mews, eZee และ Furama ยังไม่รองรับในขณะนี้
5. รีเฟรช Settings → Payment หลังเปลี่ยนการเชื่อมต่อ PMS
6. ติดต่อ support หาก AVA หรือ Opera ยังคงซ่อนการควบคุม

Rounding adjustment ยังไม่ทำงาน

สิ่งที่เห็น: Rounding adjustment ยังเป็นสีเทา หรือค่าที่บันทึกไว้ไม่เปลี่ยนพฤติกรรมการชำระเงิน

วิธีแก้:

1. เปิด Settings → Check-In → Check-In Policy
2. เปิด Check-in outstanding-balance blocking หรือ Checkout balance settlement
3. บันทึกการตั้งค่า
4. กลับไปที่ Settings → Payment และยืนยันว่าค่า rounding ยังถูกบันทึกไว้

ยังแก้ไม่ได้ใช่ไหม

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

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

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

• ภาพหน้าจอของ Settings → Payment
• ชื่อ provider ของ PMS
• reservation ID และ timestamp ตัวอย่าง

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

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