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

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

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

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

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

ตำแหน่งเมนู​

Settings → Payment

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

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

ก่อนเริ่ม​

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

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

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

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

สำหรับ Stripe​

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

สำหรับ Red Dot Payment​

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

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

Toggleทำอะไร
Collect Security Depositsทำ pre-authorize เงินมัดจำระหว่างเช็กอิน
Collect Full Paymentให้ผู้เข้าพักชำระยอดคงค้างระหว่างเช็กอิน
  1. เปิดหนึ่งตัวหรือทั้งสองตัว
  2. หากปิดทั้งสองตัว ระบบเช็กอินจะไม่ร้องขอการชำระเงิน
  3. คลิก Save Payment Gateway Settings

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

  1. กรอก Deposit Amount
  2. เลือก Deposit Type (ต่อคืนหรือยอดคงที่)
  3. คลิก Save Payment Gateway Settings
แหล่งที่มาของสกุลเงินเงินมัดจำ

การตั้งค่า payment จะใช้ Property Currency ที่ resolve แล้วจาก Settings → Essentials → Hotel Basic Details หาก PMS เป็นผู้ส่งสกุลเงิน AVA จะใช้ค่านั้นและล็อกการแก้ไขในระบบ

ขั้นตอนที่ 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

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

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

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

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

การตั้งค่า payment ถูกย้ายจาก Settings → Essentials มาอยู่ที่ Settings → Payment

การแก้ปัญหา​

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

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

วิธีแก้:

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

ไม่เห็นเซกชัน Opera​

อาการ: ไม่เห็นการ์ด Opera mapping และ policy

วิธีแก้:

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

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

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

วิธีแก้:

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

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

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

วิธีแก้:

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

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

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

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

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

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

  • ภาพหน้าจอ Settings → Payment
  • ชื่อ PMS provider
  • ตัวอย่าง reservation ID และเวลาเกิดปัญหา