Integrasi Gateway Pembayaran

Konfigurasi Cepat

Atur gateway terlebih dahulu, lalu pilih tampilan penagihan dan aturan pembayaran. Sebagian besar hotel dapat menyelesaikannya dalam 5 menit.

Panduan ini membantu Anda mengatur pembayaran dan aturan penagihan melalui Settings → Payment. Jika Anda menggunakan Stripe, pilih Live atau Test sebelum menghubungkannya. Kredensial Stripe untuk gateway tetap berada di kartu pembayaran. Kredensial manual terminal tetap berada di kartu konfigurasi terminal dan hanya menggunakan kunci test. Jika hotel Anda menggunakan kredensial test Stripe manual, kartu gateway dan kartu terminal menyimpannya secara terpisah. Gunakan kunci test Stripe untuk setiap kartu yang Anda konfigurasi. Kebijakan biaya akomodasi mencocokkan nilai yang diberikan PMS Anda. Nama travel agent Opera seperti Booking.com (VCC) juga dapat memicu pembebasan biaya yang sesuai. Untuk pembebasan biaya paket kamar Opera, AVA terlebih dahulu membebaskan biaya kamar, biaya layanan kamar, dan GST kamar. Untuk proyeksi Opera sebelum kedatangan, biaya kamar yang diproyeksikan dan pajak rate-info-nya dibebaskan secara bersamaan. Biaya tambahan yang dicatat secara terpisah beserta pajaknya tetap harus dibayar. Untuk Mews, produk terverifikasi yang termasuk dalam tarif yang cocok, seperti sarapan bundel, dapat mengikuti pembebasan biaya akomodasi. Setelah waiver tersebut, AVA menyembunyikan saldo positif THB 0.01 hanya jika saldo itu merupakan sisa pembulatan akomodasi. Biaya tambahan yang sebenarnya dan biaya yang tidak terklasifikasi tetap harus dibayar, termasuk biaya tambahan THB 0.01 yang sebenarnya. Pemilih sumber OTA lama tidak lagi menjadi bagian dari halaman ini.

Menemukan Menu Ini

Settings → Payment

Referensi Cepat

Area Pengaturan	Yang Dikendalikan	Hasil Utama
Billing View	Ringkasan penagihan tamu secara terperinci atau sederhana	Menampilkan baris terperinci atau ringkasan yang lebih singkat
Payment Gateway Integration	Konfigurasi Stripe atau Red Dot	Tamu dapat membayar dalam alur kiosk
Stripe Environment	Mode Live atau Test untuk gateway Stripe dan koneksi terminal	Terkunci setelah terhubung
Manual Stripe Test Credentials	Kunci Stripe khusus test pada kartu gateway dan terminal	Menyimpan pengaturan Stripe gateway dan terminal secara terpisah
Terminal Payment Configuration	API key terminal Stripe, publishable key, dan webhook secret	Menyimpan kredensial terminal secara terpisah dari gateway Stripe
Payment Collection Mode	Toggle deposit dan pembayaran penuh	Mengendalikan jumlah yang dibayar tamu saat check-in
Accommodation Charge Policies	Nilai yang cocok untuk membebaskan atau menyembunyikan biaya akomodasi	Mengendalikan baris akomodasi dan jumlah yang harus dibayar saat PMS Anda mendukung kemampuan ini
AVA Billing Rules	Sinyal hide dan waive PMS untuk baris kamar, pajak, deposit, dan incidental	Menampilkan baris tersembunyi sebagai ✅, menjaga total yang harus dibayar tetap numerik, dan mempertahankan biaya tambahan yang harus dibayar
Property Currency (di Settings → Essentials)	Mata uang yang ditetapkan untuk deposit dan tampilan pembayaran reservasi	Menjaga jumlah pembayaran konsisten di seluruh pengaturan dan operasi
Deposit Currency	Mata uang yang digunakan untuk jumlah deposit di halaman ini	Disimpan bersama pengaturan pembayaran lainnya
Opera Payment Mapping	Pemetaan settlement, cashier, dan payment type	Opera menerima posting pembayaran dengan benar
Checkout Rounding Adjustment	Toleransi saldo kecil dan penyesuaian saat checkout	PMS yang didukung dapat menyelesaikan checkout dengan saldo kecil
Pre-Authorization Controls	Penagihan tarif kamar yang ditunda dari pre-authorization Stripe	Muncul saat PMS aktif Anda mendukung delayed capture
Opera-Specific Payment Controls	Verifikasi check-out, praotorisasi, dan logika no-collect	Perilaku pembayaran khusus Opera diberlakukan

Ketergantungan pembulatan

Rounding adjustment hanya berfungsi jika Check-in outstanding-balance blocking atau Checkout balance settlement aktif di Check-In Policy. Jika keduanya nonaktif, AVA tetap menyimpan nilai pembulatan Anda, tetapi kontrolnya tetap tidak aktif. AVA hanya menampilkan kontrol ini jika PMS aktif Anda melaporkan dukungan pembulatan checkout. Data kemampuan yang tidak ada atau salah format membuat kontrol tetap tersembunyi.

Kontrol berbasis kemampuan

AVA membaca dukungan pembulatan checkout dari kemampuan PMS aktif Anda. AVA hanya menampilkan Transaction Code (Rounding) jika kemampuan tersebut menyatakan adanya kolom vendor code. Kemampuan PMS yang tidak didukung atau belum terverifikasi tidak mengirimkan pengaturan pembulatan baru.

Sebelum Memulai

• Siapkan akun gateway pembayaran.
• Tentukan apakah Anda ingin tampilan penagihan Detailed atau Simplified.
• Tentukan apakah Anda ingin deposit, pembayaran penuh, atau keduanya
• Konfirmasikan kebijakan deposit dan sumber mata uang properti di Settings → Essentials → Hotel Basic Details.
• Pastikan PMS Anda menyediakan kemampuan kebijakan pembayaran akomodasi. Jika AVA tidak dapat mengonfirmasi dukungan, kontrolnya tetap tersembunyi.
• Pastikan PMS Anda menyediakan dukungan delayed pre-authorization capture jika Anda memerlukan Auto Delay Capture.
• Jika Anda menggunakan Opera, aturan penagihan AVA tersedia di sana terlebih dahulu.
• Jika PMS Anda mendukung pemetaan pembayaran, siapkan pemetaan cashier ID dan payment method code.

Konfigurasi Langkah demi Langkah

Langkah 1: Memilih Gateway Pembayaran

1. Buka Settings → Payment.
2. Di Payment Gateway Integration, pilih Stripe atau Red Dot Payment.

Untuk Stripe

1. Buka Advanced.
2. Pilih Live atau Test.
3. Klik Connect Stripe.
4. Selesaikan proses onboarding Stripe.
5. Kembali ke Streamliner dan pastikan Stripe sudah terhubung.

Mode Stripe

Gunakan Live untuk produksi dan Test untuk onboarding sandbox. Setelah Stripe terhubung, pilihan lingkungan menjadi hanya-baca sampai Anda memutuskan koneksi.

Konfigurasi terminal Stripe juga secara default menggunakan Live, kecuali Anda mengubahnya sebelum menghubungkan.

Kredensial Test Stripe Manual

Gunakan bagian ini saat hotel Anda mengaktifkan kolom kredensial test Stripe manual.

1. Buka kartu Stripe yang ingin Anda edit.
2. Masukkan Publishable Key, Secret Key, dan Webhook Secret.
3. Gunakan kunci khusus test untuk kartu tersebut.
4. Klik Save.
5. Jika kolom nantinya disamarkan, klik Save lagi tanpa mengetik ulang nilainya.

Kartu Stripe terpisah

Kredensial Stripe gateway disimpan di kartu gateway pembayaran. Kredensial Stripe terminal disimpan di kartu konfigurasi terminal. Pisahkan kunci gateway dan terminal.

Terminal checkout

Saat kiosk memiliki satu terminal Stripe yang dipetakan, AVA membukanya secara otomatis saat checkout. Saat lebih dari satu terminal dipetakan, Anda dapat memilihnya dari pemilih terminal di dialog pembayaran. Jika mode terminal nonaktif, AVA mempertahankan alur gateway atau pembayaran QR. Jika kiosk menggunakan kredensial Stripe Terminal langsung, AVA tetap dapat memulai checkout meskipun Stripe Account ID kosong. Jika kredensial langsung dan akun Connect sama-sama tersedia, AVA mempertahankan perilaku akun Connect. Kredensial manual terminal terpisah dari kredensial Stripe gateway. Gunakan kredensial tersebut hanya untuk terminal test. Jika kolom disamarkan, Anda dapat menyimpannya lagi tanpa mengetik ulang nilainya.

Untuk Red Dot Payment

1. Masukkan Merchant ID.
2. Masukkan Secret Key.
3. Pilih Environment (TEST atau LIVE).
4. Klik Save Payment Gateway Settings.

Langkah 2: Memilih Billing View

Gunakan kartu ini untuk mengatur ringkasan penagihan yang dilihat tamu. Pilih Detailed untuk baris terperinci. Pilih Simplified untuk Room Charges, Tax, dan total.

1. Buka Settings → Payment.
2. Di Billing View, pilih Detailed atau Simplified.
3. Klik Save.

Posisi billing view

Kartu ini muncul sebelum Terminal Payment Configuration di halaman pembayaran.

Langkah 3: Memilih Opsi Pengumpulan Pembayaran

Toggle	Fungsinya
Collect Security Deposits	Melakukan praotorisasi deposit saat check-in
Collect Full Payment	Tamu membayar saldo terutang saat check-in

1. Aktifkan salah satu toggle atau keduanya.
2. Jika keduanya nonaktif, proses check-in tidak meminta pembayaran.
3. Klik Save Payment Gateway Settings.

Langkah 4: Mengonfigurasi Detail Deposit (Jika Diaktifkan)

1. Masukkan Deposit Amount.
2. Pilih Deposit Type (per malam atau jumlah tetap).
3. Jika Anda melihat Deposit Currency, pilih mata uang yang digunakan hotel untuk deposit.
4. Klik Save Payment Gateway Settings.

Sumber mata uang deposit

Pengaturan pembayaran menggunakan Property Currency yang ditetapkan di Settings → Essentials → Hotel Basic Details. Jika PMS menyediakan mata uang, AVA menggunakan nilai tersebut dan mengunci pengeditan lokal. Deposit Currency yang Anda pilih disimpan bersama pengaturan pembayaran lainnya.

Mengonfigurasi Kebijakan Biaya Akomodasi

Gunakan kontrol ini jika PMS Anda mendukung kebijakan pembayaran akomodasi. Kontrol ini muncul di bawah Payment Policy Controls pada Settings → Payment.

Kontrol	Fungsinya
Waive Accommodation Charges	Tidak menagih biaya akomodasi, pajak terkait, atau biaya layanan. Baris tersebut tetap terlihat.
Hide and Waive Accommodation Charges	Menyembunyikan dan tidak menagih biaya akomodasi, pajak terkait, atau biaya layanan.

Biaya tambahan yang dicatat terpisah beserta pajaknya tetap terlihat dan harus dibayar dalam kebijakan mana pun. Jika kedua kebijakan cocok, kebijakan hide hanya mengubah visibilitas. Jumlah yang harus dibayar tetap sama.

1. Buka Settings → Payment.
2. Cari Payment Policy Controls → Accommodation Charge Policies.
3. Tambahkan setiap nilai yang cocok dari PMS Anda ke daftar yang sesuai.
4. Klik Save Payment Policies.
5. Uji reservasi yang cocok dengan nilai yang dikonfigurasi.

Visibilitas berbasis kemampuan

AVA menampilkan kontrol ini hanya saat PMS aktif menyediakan kemampuan yang diperlukan. Nilai yang sudah ada tetap tersimpan saat kontrol untuk sementara tidak tersedia.

Label sumber Opera

Jika Opera mengembalikan label travel agent, AVA dapat mencocokkan nilai seperti Booking.com (VCC).

Aturan Penagihan AVA

Gunakan bagian ini saat PMS Anda mengirimkan sinyal hide atau waive untuk baris kamar, pajak, deposit, atau incidental.

• Mews dan Opera mendukung aturan ini jika kemampuan koneksinya memungkinkan.
• Baris kamar atau pajak yang disembunyikan ditampilkan sebagai ✅ dalam penagihan terperinci.
• Baris kamar atau pajak yang dibebaskan tetap terlihat saat penyedia mengembalikannya.
• Kebijakan pembebasan Mews v2 dapat menghapus baris biaya dari seluruh invoice.
• Produk Mews terverifikasi yang termasuk dalam tarif, seperti sarapan bundel, dapat mengikuti pembebasan biaya paket kamar.
• Aturan kelompok tarif Mews hanya berlaku untuk produk yang termasuk dalam kelompok tarif yang dipesan.
• Produk yang ditetapkan ke kelompok tarif lain tetap harus dibayar.
• Biaya layanan yang dihitung relatif terhadap produk yang disertakan dan telah diverifikasi dapat mengikuti pembebasan tersebut.
• Saldo Mews positif hingga THB 0.01 hanya disembunyikan jika saldo itu merupakan sisa pembulatan akomodasi setelah pembebasan biaya.
• Biaya positif yang tidak terklasifikasi dan biaya tambahan yang sebenarnya tetap harus dibayar, termasuk biaya tambahan THB 0.01 yang sebenarnya.
• Untuk pembebasan biaya paket kamar Opera, AVA terlebih dahulu membebaskan biaya kamar, biaya layanan kamar, dan GST kamar.
• Biaya kamar Opera sebelum kedatangan yang diproyeksikan beserta pajak rate-info-nya dibebaskan secara bersamaan.
• Biaya tambahan Opera yang dicatat secara terpisah beserta pajaknya dapat tetap harus dibayar.
• Baris deposit atau incidental yang dibebaskan dihapus dari total yang harus dibayar.
• Jumlah yang harus dibayar setelah evaluasi menentukan saldo yang ditampilkan dan ditagihkan saat checkout.
• Jika penagihan tidak dievaluasi karena alasan lain, AVA dapat menggunakan ringkasan PMS atau snapshot yang tersimpan.
• Pembebasan Mews yang tidak konklusif tidak menggunakan jumlah yang belum terverifikasi; staf harus meninjau invoice lengkap.
• Saat pengumpulan pembayaran kamar diaktifkan, AVA dapat mengarahkan tamu ke resepsionis saat mencari reservasi.
• Jika AVA tidak dapat membuktikan klasifikasi produk, AVA menahan jumlah yang belum terverifikasi untuk ditinjau staf.
• Saldo nol Opera yang eksplisit tetap nol, meskipun posting kamar, pajak, atau layanan yang terlihat tampak positif. Hal ini berlaku saat pasangan posting yang dirutekan atau diselesaikan tidak terlihat. AVA mempercayai saldo nol itu hanya jika jumlah dan mata uangnya cocok dengan tagihan Opera yang dinormalisasi. Ketidakcocokan tetap belum terkonfirmasi.
• Penagihan sederhana menampilkan baris kamar dan pajak yang disembunyikan, pemisah Extras, dan item tambahan yang dikelompokkan berdasarkan kode.
• Baris penagihan yang diproyeksikan dapat tetap terlihat saat PMS menyelesaikan sinkronisasi.
• Bandingkan saldo yang tidak terduga dengan PMS sebelum menagih pembayaran.
• Jika tidak ada kebijakan yang cocok, AVA menggunakan respons billing yang diterimanya.

Peluncuran berbasis kemampuan

Jika PMS Anda tidak mendukung aturan penagihan AVA, AVA mempertahankan ringkasan pembayaran normal.

1. Buka reservasi yang menggunakan aturan billing PMS.
2. Refresh reservasi di AVA.
3. Bandingkan baris yang terlihat dengan saldo yang harus dibayar.
4. Uji lagi setelah sinkronisasi PMS selesai.

Langkah 5: Konfigurasikan Pemetaan Pembayaran PMS (Saat Didukung)

1. Di Opera PMS Payment Mapping, atur:
   • Settlement Code
   • Default Cashier ID
   • Default Comment Type / Location
   • Baris Payment Type to Payment Method Code
2. Klik Save Opera Payment Mapping.

Cara kerja baris pemetaan

Setiap baris menghubungkan satu metode pembayaran ke satu kode metode pembayaran OPERA. AVA menyimpan baris ini bersama pengaturan pembayaran Anda yang lain.

Default komentar pembayaran Opera

AVA mengirimkan Default Comment Type / Location yang Anda konfigurasikan saat membuat komentar pembayaran atau deposit Opera. Simpan pemetaan lagi setelah mengubah nilai ini.

Ketersediaan berbasis kemampuan

Bagian pemetaan dapat tetap menggunakan istilah khusus Opera. Visibilitasnya mengikuti kemampuan pemetaan pembayaran dari integrasi PMS aktif Anda.

Langkah 6: Konfigurasikan Penyesuaian Pembulatan Checkout

AVA menampilkan kontrol ini di bawah Payment Policy Controls saat PMS Anda mendukungnya.

Penyedia PMS	Dukungan	Penyiapan tambahan
AVA	Didukung	Tidak memerlukan vendor code
Opera / OHIP	Didukung	Simpan vendor code di Transaction Code (Rounding)
Cloudbeds, Mews, eZee, dan Furama	Tidak didukung	Kontrol tetap tersembunyi

1. Buka Settings → Check-In → Check-In Policy.

2. Aktifkan Check-in outstanding-balance blocking atau Checkout balance settlement.

3. Buka Settings → Payment.

4. Cari Payment Policy Controls.

5. Aktifkan Enable Rounding Adjustment.

6. Atur Rounding Threshold dalam mata uang default properti Anda.

7. Jika Anda menggunakan Opera, masukkan vendor code di Transaction Code (Rounding).

8. Klik Save Payment Policies.

   ✓ AVA menerapkan penyesuaian saat checkout ketika saldo berada dalam ambang batas Anda.

Cara kerja penyesuaian

Saat check-in, AVA menerima saldo dalam ambang batas yang dikonfigurasi tanpa memposting transaksi. Saat checkout, AVA memposting penyesuaian pembulatan sebelum menyelesaikan checkout. AVA tidak menggunakan vendor code. Opera menggunakan vendor code yang dikonfigurasi.

Langkah 7: Konfigurasikan Auto Delay Capture

Gunakan Auto Delay Capture saat PMS Anda mendukung delayed capture. AVA menangkap tarif kamar sebelum pre-authorization Stripe kedaluwarsa. Deposit tetap belum ditangkap.

Pengaturan	Fungsinya
Enable Auto Delay Capture	Secara otomatis menangkap tarif kamar sebelum pre-authorization kedaluwarsa
Auto Delay Capture Expiry Days	Menentukan berapa hari sebelum kedaluwarsa AVA menangkap tarif kamar

1. Buka Settings → Payment.

2. Cari Payment Policy Controls → Pre-Authorization Controls.

3. Aktifkan Enable Auto Delay Capture.

4. Masukkan Auto Delay Capture Expiry Days.

5. Klik Save Payment Policies.

   ✓ AVA menangkap tarif kamar sebelum kedaluwarsa ketika pre-authorization masih valid.

Visibilitas berbasis kapabilitas

AVA menampilkan kontrol ini hanya saat PMS aktif Anda melaporkan dukungan delayed capture. Opera saat ini melaporkan dukungan tersebut. Penyedia PMS lain hanya menampilkan kontrol setelah melaporkan kapabilitas yang sama.

Perubahan PMS dapat menghapus pengaturan ini

Jika Anda beralih ke PMS tanpa dukungan delayed capture, AVA menonaktifkan Auto Delay Capture. AVA juga menghapus nilai hari kedaluwarsanya untuk mencegah pengaturan lama digunakan.

Langkah 8: Konfigurasikan Kontrol Pembayaran Khusus Opera (Hanya Opera)

1. Buka Settings → Payment.

2. Cari Opera-Specific Payment Controls.

3. Atur perilaku pembayaran:

   • Akses invoice in-house dan verifikasi tanggal lahir untuk check-out
   • Perilaku Ignore Waive Payment Routing

4. Di Do Not Collect Any Incidental / Deposit, tambahkan setiap rate code, market segment, guarantee type, atau komentar yang cocok.

5. Klik Save Payment Policies.

   ✓ Baris incidental atau deposit yang cocok dihapus dari saldo yang harus dibayar.

Komentar pembayaran Opera

AVA mencoba menambahkan komentar reservasi Opera sebelum memposting pembayaran atau deposit. Jika pembuatan komentar gagal, AVA tetap memposting pembayaran atau deposit di Streamliner. Ini membuat pengumpulan pembayaran tetap berjalan meskipun pembuatan komentar Opera gagal. Kebijakan biaya akomodasi dikonfigurasi di atas.

Dependensi Penyesuaian Pembulatan

Gunakan ini saat Anda ingin pembulatan checkout memengaruhi perilaku pembayaran.

1. Buka Settings → Check-In → Check-In Policy.

2. Aktifkan Check-in outstanding-balance blocking atau Checkout balance settlement.

3. Kembali ke Settings → Payment.

4. Buka Payment Policy Controls dan atur Enable Rounding Adjustment.

   ✓ AVA menerapkan pengaturan pembulatan hanya ketika salah satu kebijakan tersebut aktif.

Nilai yang disimpan tetap ada

Jika nanti Anda menonaktifkan kedua kebijakan saldo check-in, AVA tetap menyimpan nilai pembulatan yang tersimpan. Kontrol tersebut hanya berhenti memengaruhi perilaku pembayaran.

Yang Diharapkan Setelah Disimpan

• ✅ Detail gateway yang terhubung muncul setelah penyiapan
• ✅ Stripe menampilkan Live atau Test pada lencana status yang terhubung
• ✅ Billing view tersimpan bersama pengaturan pembayaran lainnya
• ✅ Kolom deposit muncul saat deposit diaktifkan
• ✅ Mata uang deposit tetap tersimpan setelah Anda mengeklik Save
• ✅ Auto Delay Capture hanya muncul saat PMS aktif Anda mendukungnya
• ✅ Pemetaan pembayaran PMS muncul saat PMS aktif melaporkan dukungan
• ✅ Bagian kebijakan Opera hanya muncul untuk PMS Opera
• ✅ Kartu pemetaan pembayaran dapat muncul untuk PMS non-Opera saat integrasinya melaporkan dukungan
• ✅ Pengaturan pembayaran tersimpan secara independen di halaman yang sama

Catatan Migrasi

Penyiapan pembayaran dipindahkan dari Settings → Essentials ke Settings → Payment. Pemilih sumber OTA lama telah dihapus.

Pemecahan Masalah

Pengaturan gateway dinonaktifkan

Yang terlihat: Toggle pembayaran atau tombol simpan dinonaktifkan.

Perbaikan:

1. Pastikan akun Anda memiliki akses tulis ke pengaturan.
2. Hubungkan Stripe terlebih dahulu jika Stripe dipilih.
3. Refresh halaman lalu coba lagi.

Billing view tidak berubah

Yang terlihat: Tamu masih melihat tata letak ringkasan billing lama.

Perbaikan:

1. Kembali ke Settings → Payment.
2. Pilih ulang Detailed atau Simplified.
3. Klik Save pada kartu Billing View.
4. Mulai alur tamu baru atau refresh layar reservasi.
5. Jika masih terlihat salah, pastikan hotel menggunakan jalur pengaturan CCI terbaru.

Environment Stripe terkunci

Yang terlihat: Dropdown Environment dinonaktifkan setelah Stripe terhubung.

Perbaikan:

1. Putuskan Stripe.
2. Buka Advanced.
3. Pilih Live atau Test.
4. Hubungkan kembali Stripe.

Kredensial terminal Stripe ditolak

Yang terlihat: Kredensial gateway atau terminal Stripe tidak tersimpan, atau AVA menghapusnya setelah Anda menyimpan.

Perbaikan:

1. Pastikan Anda mengedit kartu Stripe yang benar.
2. Kredensial gateway dan terminal disimpan secara terpisah.
3. Gunakan nilai khusus test untuk penyiapan Stripe manual.
4. Pastikan kunci rahasia diawali dengan sk_test_.
5. Pastikan kunci publishable diawali dengan pk_test_.
6. Simpan kembali pengaturan.
7. Jika kolom tersamarkan, simpan lagi tanpa mengetik ulang nilainya.

Kredensial test Stripe tidak muncul

Yang terlihat: Kolom Stripe manual tidak ada pada kartu gateway atau terminal.

Perbaikan:

1. Refresh Settings → Payment.
2. Pastikan hotel Anda termasuk dalam peluncuran kredensial test Stripe manual.
3. Hubungi dukungan jika kolom tetap tidak muncul.

Kontrol kebijakan pembayaran tidak muncul

Yang terlihat: Kontrol pembayaran akomodasi, pembulatan checkout, atau khusus Opera tidak ada.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan PMS aktif sudah benar.
3. Kembali ke Settings → Payment.
4. Refresh halaman sekali.
5. Minta administrator memastikan kapabilitas PMS diaktifkan.

Pemetaan pembayaran PMS

Pemetaan pembayaran muncul saat PMS aktif melaporkan dukungan. Opera saat ini melaporkan kemampuan tersebut. Bagian pemetaan terpisah dari kontrol kebijakan pembayaran lain yang bergantung pada kemampuan.

Auto Delay Capture tidak tersedia

Yang terlihat: Pre-Authorization Controls tidak menampilkan Auto Delay Capture.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan PMS yang benar sedang aktif.
3. Refresh Settings → Payment setelah mengubah koneksi PMS.
4. Tanyakan kepada administrator atau dukungan Vouch apakah PMS melaporkan dukungan delayed capture.

Jika PMS tidak melaporkan dukungan, kontrol tetap tersembunyi. Ini adalah perilaku yang diharapkan.

Pengaturan Auto Delay Capture ditolak

Yang terlihat: AVA menyatakan delayed capture tidak tersedia saat Anda menyimpan pengaturan pembayaran.

Perbaikan:

1. Pastikan PMS aktif mendukung delayed capture.
2. Nonaktifkan Auto Delay Capture jika Anda mengganti penyedia PMS.
3. Simpan pengaturan pembayaran.
4. Coba lagi setelah kapabilitas PMS tersedia.

AVA tidak menyimpan pengaturan delayed capture untuk PMS yang tidak didukung atau belum terverifikasi.

Pemetaan pembayaran Opera tidak tersimpan

Yang terlihat: Baris cashier atau metode pembayaran Anda hilang setelah mengeklik Save.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan PMS yang benar sedang aktif dan melaporkan dukungan pemetaan pembayaran.
3. Kembali ke Settings → Payment.
4. Masukkan kembali Default Cashier ID dan setiap baris pemetaan.
5. Klik Save Opera Payment Mapping lagi.

Mata uang pembayaran Opera tidak cocok

Yang terlihat: Opera menampilkan kesalahan internal, atau pembayaran atau deposit tidak muncul setelah diposting.

Perbaikan:

1. Periksa Property Currency di Settings → Essentials → Hotel Basic Details.
2. Pastikan reservasi Opera menggunakan mata uang yang sama.
3. Coba lagi pembayaran atau deposit tersebut.
4. Hubungi dukungan jika Opera tetap mengembalikan kesalahan internal.

Komentar reservasi Opera hilang

Yang terlihat: Pembayaran berhasil diposting, tetapi Anda tidak melihat komentar reservasi baru di Opera.

Perbaikan:

1. Pastikan pembayaran atau deposit selesai dengan sukses di Streamliner.
2. Periksa bahwa reservasi Opera memiliki catatan pembayaran yang sesuai.
3. Pastikan Default Comment Type / Location telah diatur di Opera PMS Payment Mapping.
4. Jangan mencoba lagi hanya untuk membuat ulang komentar.
5. Hubungi dukungan jika pembayaran terposting tetapi komentar tetap tidak muncul.

Tipe atau lokasi komentar Opera terlihat salah

Yang terlihat: Opera membuat komentar pembayaran, tetapi tipe atau lokasinya terlihat tidak sesuai.

Perbaikan:

1. Buka Settings → Payment.
2. Periksa Opera PMS Payment Mapping.
3. Verifikasi Default Comment Type / Location.
4. Simpan pemetaan lagi.
5. Uji pembayaran atau deposit Opera lainnya.

Pembayaran kamar di-waive tanpa diduga

Yang terlihat: Reservasi melewati pembayaran kamar padahal Anda mengharapkan permintaan pembayaran.

Perbaikan:

1. Buka reservasi di PMS Anda.
2. Periksa komentar reservasi, nama sumber, dan label travel agent Opera.
3. Hapus atau ubah nilai yang cocok jika reservasi seharusnya tidak di-waive.
4. Refresh AVA dan uji lagi dengan reservasi baru.

Kontrol kebijakan akomodasi tidak tersedia

Yang terlihat: Anda tidak melihat Accommodation Charge Policies, atau AVA menampilkan pesan PMS yang tidak didukung.

Perbaikan:

1. Pastikan penyedia PMS Anda mendukung kebijakan pembayaran akomodasi.
2. Refresh Settings → Payment.
3. Jika kontrol tetap tidak muncul, AVA belum memiliki data dukungan untuk PMS tersebut.
4. Pertahankan nilai kebijakan yang sudah ada. AVA tetap menyimpannya saat editor tersembunyi.

Baris billing tidak cocok dengan PMS

Yang terlihat: Baris kamar, pajak, deposit, atau incidental terlihat berbeda di AVA.

Perbaikan:

1. Pastikan reservasi berasal dari PMS yang mendukung aturan billing AVA.
2. Jika Anda menggunakan Opera, tunggu sinkronisasi reservasi berikutnya.
3. Refresh Settings → Payment atau buka kembali reservasi.
4. Periksa tagihan di PMS untuk memastikan apakah baris tersebut disembunyikan atau di-waive.

Produk Mews yang disertakan perlu ditinjau

Yang terlihat: Produk Mews yang dibundel perlu ditinjau setelah waiver paket kamar yang cocok.

Mengapa ini terjadi: AVA tidak dapat membuktikan klasifikasi produk.

Perbaikan:

1. Buka reservasi melalui Staff Access.
2. Tinjau tarif reservasi, produk yang disertakan, dan invoice lengkap di Mews.
3. Pastikan reservasi cocok dengan kebijakan akomodasi yang dikonfigurasi.
4. Refresh reservasi di AVA.
5. Jangan tagih jumlah yang belum terverifikasi.
6. Minta staf resepsionis meninjau invoice Mews lengkap.

Tamu diarahkan ke resepsionis sebelum pembayaran

Yang terlihat: Tamu tidak dapat melanjutkan setelah pencarian reservasi. AVA meminta tamu menemui resepsionis.

Mengapa ini terjadi: Kebijakan pembayaran cocok, tetapi Mews tidak dapat mengklasifikasikan biaya yang diatur.

Perbaikan:

1. Tinjau tarif Mews, produk yang disertakan, dan invoice lengkap.
2. Pastikan nilai yang cocok terdapat dalam Accommodation Charge Policies.
3. Refresh reservasi setelah Mews selesai disinkronkan.
4. Konfirmasi jumlah yang harus dibayar dengan invoice Mews lengkap.
5. Minta staf resepsionis menyelesaikan check-in saat peninjauan masih diperlukan.

Jangan tagih jumlah yang belum terverifikasi.

Tamu tidak diminta membayar

Yang terlihat: Tamu melewati pembayaran saat check-in.

Perbaikan:

1. Pastikan gateway terhubung.
2. Pastikan Collect Security Deposits atau Collect Full Payment diaktifkan.
3. Pastikan reservasi memiliki saldo terutang.
4. Simpan dan uji lagi dengan reservasi contoh.

Mata uang deposit terlihat salah atau tidak dapat diedit

Yang terlihat: Mata uang deposit tidak sesuai dengan pengaturan yang diharapkan, atau perubahan kolom tidak tersimpan.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.
2. Periksa apakah Property Currency dikelola PMS atau dapat diedit.
3. Jika dikelola PMS, perbarui mata uang di PMS dan tunggu sinkronisasi.
4. Refresh Settings → Payment dan verifikasi mata uangnya.

Checkout rounding tidak tersedia

Yang terlihat: Enable Rounding Adjustment tidak muncul.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Konfirmasi penyedia PMS aktif.
3. AVA dan Opera mendukung checkout rounding.
4. Cloudbeds, Mews, eZee, dan Furama saat ini tidak mendukungnya.
5. Refresh Settings → Payment setelah koneksi PMS berubah.
6. Hubungi dukungan jika AVA atau Opera tetap menyembunyikan kontrol tersebut.

Penyesuaian pembulatan tetap tidak aktif

Yang terlihat: Rounding adjustment tetap berwarna abu-abu, atau nilai yang tersimpan tidak mengubah perilaku pembayaran.

Perbaikan:

1. Buka Settings → Check-In → Check-In Policy.
2. Aktifkan Check-in outstanding-balance blocking atau Checkout balance settlement.
3. Simpan pengaturan.
4. Kembali ke Settings → Payment dan pastikan nilai pembulatan tetap tersimpan.

Masih Mengalami Kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Pembayaran tetap gagal setelah pengaturan disimpan ulang
• ❌ Perubahan billing view tidak muncul bagi tamu
• ❌ Kontrol delayed capture tetap tidak tersedia untuk PMS yang didukung
• ❌ Nilai pemetaan Opera tidak tersimpan
• ❌ Koneksi Stripe atau Red Dot berulang kali terputus

Sebaiknya sertakan:

• Screenshot Settings → Payment
• Nama penyedia PMS
• ID reservasi dan timestamp contoh

Panduan Terkait

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