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. Pembulatan checkout hanya dikonfigurasi di halaman ini. Halaman Check-In dan wizard Assisted Check-In Setup tidak memiliki kontrol pembulatan. 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 agen perjalanan 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. 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. 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	Sakelar deposit dan pembayaran penuh	Mengendalikan jumlah yang dibayar tamu saat check-in
ACI payment switch	Apakah staf assisted check-in dapat meminta pembayaran	Mengizinkan atau melewati pembayaran hanya selama ACI
Pre-arrival online payments	Sakelar pembayaran kamar dan deposit, waktu email, serta skenario praotorisasi	Mengendalikan pembayaran online yang memenuhi syarat sebelum kedatangan
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
PMS Payment Mapping	Pemetaan metode pembayaran khusus properti saat PMS Anda mendukungnya	PMS mencatat pembayaran yang ditangkap dalam kategori yang dimaksud
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
No Post Controls	Mengontrol pembatasan posting OPERA berdasarkan perjalanan dan kebijakan deposit	Menerapkan aturan prioritas yang dijelaskan di bawah

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.

Ketersediaan terminal PMS

AVA hanya menampilkan opsi terminal PMS jika kemampuan PMS aktif Anda mendukungnya. Untuk provider lama ows, AVA tidak menawarkan opsi OPI. Pengaturan terminal PMS yang didukung dan sudah ada tetap berfungsi.

Memahami No Post OPERA untuk perjalanan v4

Konfigurasi Cepat

Untuk perjalanan v4, AVA memeriksa kebijakan pembayaran terlebih dahulu, lalu sakelar No Post yang cocok. Peninjauan ini memerlukan waktu sekitar 2 menit.

AVA menerapkan No Post menggunakan aturan pertama yang cocok di bawah ini.

Prioritas	Kapan berlaku	Hasil
1	Assisted Check-In terautentikasi	Pilihan staf menentukan jika ACI dua perangkat mendukungnya. Jika tidak, default tersimpan yang menentukan.
2	Kiosk atau Pre-arrival yang memenuhi syarat dengan pembayaran aktif dan Do not collect atau deposit 0	No Post, terlepas dari sakelar
3	Kiosk dengan pembayaran aktif dan deposit wajib	Set No Post after Payment yang menentukan; saat aktif, setiap tamu kiosk menerima No Post
4	Kiosk dengan pembayaran nonaktif	Set No Post after Payment yang menentukan
5	Pre-arrival dengan deposit wajib atau tanpa pembayaran	Mengikuti kebijakan pembayaran yang dikonfigurasi

Untuk Assisted Check-In, AVA memeriksa keputusan perangkat staf yang terautentikasi sebelum aturan deposit. Header ACI palsu tidak dapat melewati kebijakan tamu. Pilihan ini berlaku untuk setiap reservasi yang di-check-in oleh PMS selama tindakan tersebut. Ini mencakup reservasi utama dan sharer yang baru di-check-in. Pilihan ini tidak menerapkan kembali pembatasan pada reservasi yang sudah berada di kamar. Perbaikan ACI mengikuti pengaturan ACI; perbaikan kiosk mengikuti aturan kiosk. Perilaku v2 lama tidak berubah.

Saat Set No Post after Payment nonaktif, tamu kiosk menerima No Post hanya jika deposit wajib tidak ditagih. Saat pembayaran nonaktif, hanya Set No Post after Payment yang menentukan hasil kiosk.

Memilih pengaturan No Post

1. Buka Settings → Payment.

2. Buka Opera-Specific Payment Controls.

3. Biarkan Set No Post after Payment aktif jika setiap tamu kiosk yang memenuhi syarat harus menerima No Post.

4. Gunakan Tick No Post by default on Assisted Check-In untuk memilih pilihan staf secara default.

5. Tinjau Deposit Collection dan Do not collect karena keduanya dapat menjadi prioritas.

6. Klik Save Payment Policies.

   ✓ AVA menggunakan pengaturan tersimpan pada perjalanan berikutnya yang memenuhi syarat.

Saat pengaturan disembunyikan

AVA menyembunyikan Set No Post after Payment saat pembayaran aktif dan Do not collect dipilih. Aturan prioritas tertinggi sudah memaksa No Post dalam kondisi tersebut. AVA tetap menyediakan Tick No Post by default on Assisted Check-In untuk kebijakan ACI.

Membiarkan staf ACI dua perangkat menentukan pilihan

Saat OPERA melaporkan dukungan, kiosk staf dua perangkat yang terverifikasi menampilkan Set No Post in the PMS di atas Proceed to Check-In. Pengaturan tersimpan memilih kotak ini secara default. Staf dapat memilih atau menghapusnya sebelum check-in.

Pilihan staf bersifat final untuk tindakan ACI tersebut. Pilihan ini berlaku untuk setiap reservasi yang di-check-in OPERA selama tindakan tersebut. Untuk check-in beberapa kamar secara atomik, semua kartu kamar menggunakan satu pilihan yang sama. Pengaturan deposit tidak menggantikan pilihan ACI ini.

Kotak ini tidak ditampilkan pada kiosk staf satu perangkat atau tablet tamu. Alur tersebut menggunakan pengaturan tersimpan. Build staf lama juga tetap menggunakan pengaturan tersimpan.

Sharer kiosk

Check-in kiosk mandiri menerapkan No Post pada reservasi yang baru dimasukkan ke hotel oleh tindakan tersebut. Kedatangan pendamping berikutnya menerima No Post hanya pada reservasi baru milik pendamping. AVA tidak menerapkan kembali pembatasan pada pemesanan kamar saat tamu berikutnya bergabung.

No Post adalah tindak lanjut

Check-in OPERA dapat berhasil meskipun pembaruan No Post gagal. Verifikasi reservasi di OPERA dan terapkan pembatasan secara manual bila diperlukan. AVA juga melewati permintaan tersebut saat PMS tidak menyatakan dukungan No Post.

No Post tidak tersedia

Yang terlihat: Kotak No Post tidak ada, atau hasilnya berbeda dari default tersimpan.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan Opera adalah PMS yang aktif.
3. Refresh Settings → Payment.
4. Periksa apakah pembayaran aktif dan Do not collect dipilih.
5. Untuk ACI, pastikan Anda menggunakan kiosk staf dua perangkat yang terverifikasi.
6. Tinjau jenis perjalanan dan pengaturan No Post yang cocok.
7. Hubungi dukungan jika Opera aktif tetapi perilaku prioritas tidak benar.

AVA menyembunyikan Set No Post after Payment saat aturan prioritas tertinggi selalu berlaku. AVA juga menyembunyikan kontrol Opera saat kemampuan PMS tidak tersedia atau belum terverifikasi.

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. Penyimpanan gateway Stripe manual memerlukan mode Test dan ketiga kolom kredensial. Anda harus memberikan Publishable Key, Secret Key, dan Webhook Secret secara bersamaan.

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.

Lengkapi hanya kredensial test

AVA menolak penyimpanan gateway manual yang tidak lengkap. AVA mempertahankan kredensial yang ada jika penyimpanan ditolak. Untuk kolom yang disamarkan, biarkan nilai yang disamarkan tetap tidak berubah saat menyimpan.

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.

Permintaan pembayaran Assisted Check-In

Dalam Assisted Check-In, staf dapat meminta deposit, pembayaran kamar, atau keduanya untuk setiap kamar. Keduanya dipilih secara default saat kamar memiliki pembayaran yang harus dilakukan. Staf dapat menghapus salah satu item sebelum meminta pembayaran. Kamar tanpa pembayaran yang harus dilakukan dapat melanjutkan tanpa langkah pembayaran. Sakelar Let assisted check-in staff collect payments juga harus aktif. Sakelar ini aktif secara default dan tidak memengaruhi Self Check-In atau Pre-arrival.

Untuk ACI satu perangkat, permintaan pembayaran muncul setelah staf memilih Check-in. Perangkat kembali ke staf terlebih dahulu, lalu tamu menyelesaikan pembayaran. Untuk ACI dua perangkat, staf mengirim pembayaran sebagai langkah PAYMENT ke tablet tamu. Jika staf tidak mengirim item pembayaran, tablet tamu tidak memerlukan pembayaran.

Saat gateway online dan pembaca kartu sama-sama tersedia, tamu memilih Pay online atau Pay with Card Reader. Opsi online menampilkan kode QR. Opsi pembaca kartu menggunakan terminal yang dipilih staf.

Pilihan pembayaran ACI berlaku per kamar

Tinjau item yang diminta untuk setiap kamar sebelum memulai pembayaran. AVA tidak meminta item yang telah dihapus staf untuk kamar tersebut.

Menonaktifkan permintaan pembayaran Assisted Check-In

Gunakan pengaturan ini saat hotel Anda mengumpulkan pembayaran ACI di luar AVA.

1. Buka Settings → Check-In → Check-In Policy → Kiosk & payments.

2. Nonaktifkan Let assisted check-in staff collect payments.

3. Pilih Save.

   ✓ ACI tidak lagi menganggap kamar memiliki pembayaran terutang. ✓ ACI satu perangkat langsung melanjutkan ke check-in. ✓ ACI dua perangkat tidak menawarkan langkah PAYMENT.

Pengaturan ini aktif secara default. Pengaturan ini hanya memengaruhi Assisted Check-In. Aturan pembayaran Self Check-In dan Pre-arrival tetap tidak berubah.

Kapan perubahan berlaku

Kiosk memuat perubahan pada halaman Welcome berikutnya, perjalanan baru, atau saat dimuat ulang. Pembayaran tablet yang sedang terbuka dapat diselesaikan, atau staf dapat melewatinya.

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.

Pilih Pre-authorization hold sebelum memasukkan jumlahnya. Jumlah tersebut harus lebih besar dari 0 jika opsi ini diaktifkan. Untuk melewati deposit keamanan, pilih Do not collect.

Jumlah nol tidak mengaktifkan deposit

AVA menolak Deposit Amount yang kosong atau nol saat Pre-authorization hold dipilih. Pesan sebaris menjelaskan kesalahan tersebut dan menawarkan Switch to "Do not collect" instead.

Syarat koneksi gateway

AVA menonaktifkan Pre-authorization hold dan Deposit Amount sampai gateway pembayaran terhubung. Do not collect tetap tersedia agar Anda dapat menghapus konfigurasi deposit yang tidak valid.

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.

Pemeriksaan nilai pembayaran

AVA memeriksa nilai pembayaran sebelum menyimpannya. Gunakan format di bawah ini saat kolom dapat diedit.

Pengaturan	Nilai yang diterima
Deposit Currency	Tiga huruf kapital, seperti USD atau THB
Rounding Threshold	Angka 0 atau lebih tinggi
Transaction Code (Rounding)	Bilangan bulat 0 atau lebih tinggi
Auto Delay Capture Expiry Days	Bilangan bulat 0 atau lebih tinggi

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.

Mengonfigurasi Pembayaran Online Sebelum Kedatangan

Gunakan kartu ini agar tamu yang memenuhi syarat dapat membayar secara online sebelum kedatangan. Temukan kartu ini di Settings → Payment → Pre-arrival online payments. Kartu ini muncul setelah Billing View dan setelah pengaturan pengumpulan pembayaran. Konfigurasikan aturan long-stay sebelum kedatangan di Settings → Check-In → Check-In Policy.

Pengaturan	Yang dikendalikan	Persyaratan
Enable pre-arrival room payment	Mengumpulkan saldo kamar terkini sebelum kedatangan	Pengumpulan kamar harus berupa Pre-authorization hold atau Direct sale charge
Enable pre-arrival deposit payment	Meminta praotorisasi deposit yang dikonfigurasi sebelum kedatangan	Pengumpulan deposit harus berupa Pre-authorization hold
Pre-auth validity (days)	Lamanya bank mempertahankan praotorisasi tetap valid	Masukkan 1 hingga 365 hari

1. Buka Settings → Payment → Pre-arrival online payments.

2. Aktifkan toggle pembayaran kamar, toggle pembayaran deposit, atau keduanya.

3. Masukkan Pre-auth validity (days) saat Anda mengumpulkan deposit.

4. Tinjau email terjadwal pertama dan waktu pengirimannya.

5. Tinjau tabel Pre-auth scenarios.

6. Klik Save.

   ✓ AVA menyimpan pilihan kamar dan deposit secara terpisah. ✓ Tamu melihat jumlah kamar dan deposit terkini selama Pre-arrival.

Pilih pembayaran kamar dengan cermat

Aktifkan pembayaran kamar saat PMS Anda mengidentifikasi reservasi yang dibayar melalui OTA atau menyediakan rate plan yang sesuai. Hal ini membantu mencegah tamu membayar saldo kamar yang sudah dipungut oleh OTA.

Mode pengumpulan mengendalikan toggle

AVA menonaktifkan dan menghapus toggle kamar saat pengumpulan kamar adalah Do not collect. AVA menonaktifkan dan menghapus toggle deposit saat pengumpulan deposit bukan Pre-authorization hold.

Saat AVA meminta praotorisasi

AVA hanya meminta praotorisasi saat undangan pembayaran dan masa inap sesuai dengan masa berlaku yang ditetapkan. Jumlah hari sebelum kedatangan ditambah jumlah malam menginap harus kurang dari masa berlaku. AVA melewati permintaan saat tanggal tersebut sama dengan batas kedaluwarsa.

Memahami Waktu Pembayaran Kamar

Halaman saat ini tidak menyediakan kontrol waktu direct-sale terpisah. Undangan pembayaran kamar mengikuti email sebelum kedatangan yang telah dijadwalkan.

1. Buka Settings → Payment → Pre-arrival online payments.

2. Periksa email terjadwal pertama dan waktu pengirimannya.

3. Klik Configure untuk menyesuaikan jadwal di Pre-arrival Emails.

4. Tinjau setiap email terjadwal dalam tabel skenario.

   ✓ AVA menggunakan alur email terjadwal untuk undangan kamar dan deposit yang memenuhi syarat.

Waktu praotorisasi

Toggle pembayaran sebelum kedatangan secara default dinonaktifkan. Nilai default Pre-auth validity (days) adalah 7. AVA meminta praotorisasi saat waktu email dan lama menginap sesuai dengan masa berlaku tersebut.

Jenis pembayaran dan pengecualian

Pembayaran sebelum kedatangan menggunakan gateway online yang didukung. Pre-arrival dapat menggabungkan kamar terpilih yang memenuhi syarat ke dalam satu penawaran pembayaran online. AVA memeriksa ulang setiap kamar terpilih saat membuat pembayaran. Metode pembayaran terminal dan tunai tetap dikecualikan. Pembuatan pembayaran QR dan terminal ditolak untuk Pre-arrival. Tampilan penagihan Detailed atau Simplified yang dipilih mengendalikan ringkasan deposit. Pembayaran kamar direct-sale mengikuti Room collection saat diaktifkan. Pembayaran deposit tetap mengikuti aturan masa berlaku praotorisasi.

Membaca Skenario Praotorisasi

Tabel ini menampilkan satu hingga sepuluh malam untuk setiap email sebelum kedatangan yang dijadwalkan. Tabel ini membantu Anda melihat apakah penahanan dana bank tetap valid pada waktu email tersebut.

Kolom tabel	Arti
Nights	Lama masa inap tamu, dari 1 hingga 10 malam
Days to checkout	Jumlah hari email dijadwalkan sebelum kedatangan ditambah jumlah malam menginap
Request pre-auth?	Apakah penahanan dana sesuai dengan pengaturan masa berlaku Anda

AVA menampilkan ✅ saat totalnya kurang dari Pre-auth validity (days). AVA menampilkan ❌ saat totalnya mencapai atau melebihi batas masa berlaku. Setiap email terjadwal memiliki hasilnya sendiri saat Anda menggunakan beberapa email.

Contohnya, email pertama yang dikirim 5 hari sebelum kedatangan untuk masa inap 2 malam menghasilkan 7 hari. Dengan masa berlaku 8 hari, AVA menampilkan ✅ untuk skenario tersebut.

Tidak ada jadwal email

Jika penjadwalan email sebelum kedatangan tidak tersedia atau dinonaktifkan, kartu ini tidak dapat memperkirakan undangan pertama. Buka Configure di samping pesan email untuk mengatur jadwal.

Pemblokiran long-stay menonaktifkan toggle ini

Jika Pre-arrival → Block long-stay reservations diaktifkan, AVA menonaktifkan kedua sakelar. AVA juga menghapus pilihan pembayaran sebelum kedatangan yang tersimpan. Nonaktifkan aturan tersebut sebelum mengaktifkan pembayaran online Pre-arrival.

Pengaturan pembayaran sebelum kedatangan tidak tersedia

Yang terlihat: Sakelar dinonaktifkan atau kartu menyatakan bahwa pengumpulan tidak tersedia.

Perbaikan:

1. Pastikan gateway Anda terhubung di Settings → Payment.
2. Atur pengumpulan kamar ke Pre-authorization hold atau Direct sale charge sebelum mengaktifkan pembayaran kamar.
3. Atur pengumpulan deposit ke Pre-authorization hold sebelum mengaktifkan pembayaran deposit.
4. Buka Settings → Check-In → Check-In Policy.
5. Nonaktifkan Pre-arrival → Block long-stay reservations, jika sesuai.
6. Kembali ke Settings → Payment dan simpan lagi.

Pembayaran yang sudah lunas

AVA menerima status yang sudah lunas. AVA tidak meminta pembayaran kedua saat pembayaran kamar atau deposit terkait sudah selesai.

Langkah 5: Konfigurasikan Pemetaan Pembayaran PMS (Saat Didukung)

Untuk Opera, atur kolom berikut di Opera PMS Payment Mapping:

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.

AVA membaca pilihan ini dari properti Opera aktif Anda. AVA menyimpan cache setiap daftar secara terpisah di seluruh instans hingga 30 hari. Klik Refresh from OPERA saat Anda memerlukan kode terbaru. Penyegaran daftar memperbarui setiap pemilih yang cocok, termasuk kolom di halaman pengaturan lainnya.

Cara kerja baris pemetaan

Setiap baris menghubungkan satu metode pembayaran AVA ke satu kode metode pembayaran Opera. AVA menampilkan metode pembayaran Opera yang aktif dalam menu tarik-turun. Daftar tersebut mencakup deskripsi, jenis kartu, dan kode transaksi setiap metode. Anda tidak perlu memelihara daftar metode pembayaran Opera secara terpisah. AVA menyimpan baris ini bersama pengaturan pembayaran Anda yang lain.

Daftar kode Opera

Settlement Code menggunakan kode transaksi Opera. Default Cashier ID menggunakan kasir aktif dari properti Opera Anda. Baris metode pembayaran hanya menerima metode pembayaran Opera yang aktif. Pengaturan catatan reservasi menggunakan daftar jenis komentar dan lokasi Opera yang terpisah. Setiap daftar dimuat secara terpisah, sehingga satu daftar yang tidak tersedia tidak menyembunyikan daftar lainnya. Jika sebuah daftar tidak tersedia, AVA tetap menyediakan daftar lainnya. Kolom yang menggunakan daftar tidak tersedia tetap dapat diedit untuk entri manual.

Pemulihan pemetaan yang kedaluwarsa

Untuk pembayaran kartu Opera, AVA terlebih dahulu membaca pemetaan otoritatif dari Vouch Core. Dengan demikian, pemetaan yang baru saja disimpan dapat tersedia sebelum posting pembayaran. Jika Core sementara tidak tersedia, AVA dapat menggunakan pemetaan lokal terbaru yang valid. Jika AVA tidak dapat menemukan pemetaan Opera yang dapat digunakan, AVA menyegarkan konfigurasi satu kali. AVA mencoba kembali pembayaran hanya jika tidak ada permintaan pembayaran Opera yang dikirim.

Periksa kode yang disimpan

AVA mempertahankan kode tersimpan yang tidak lagi disediakan Opera, tetapi menandainya sebagai tidak tersedia. Pembayaran yang menggunakan kode tersebut tidak akan diposting ke Opera. Ganti kode yang ditandai dengan pilihan aktif sebelum menerima pembayaran.

Versi web-be-pms lama

Jika layanan Opera Anda tidak menyediakan settlement code, kolom tersebut tetap berupa teks bebas. Daftar lain yang tersedia masih dapat menggunakan dropdown.

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. Pengaturan ini tidak mengontrol catatan reservasi staf.

Ketersediaan berbasis kemampuan

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

Mengonfigurasi pemetaan metode pembayaran Mews

Gunakan pemetaan Mews saat metode yang ditangkap harus muncul di bawah kategori pembayaran Mews tertentu yang diaktifkan. Metode yang tidak dikonfigurasi tetap menggunakan perilaku posting AVA normal.

1. Pastikan Mews adalah PMS aktif Anda di Settings → Essentials → PMS Integration.

2. Buka Settings → Payment.

3. Cari Mews Payment Method Mappings.

4. Pilih metode pembayaran sumber dari katalog pembayaran saat ini. Sumber dapat mencakup PromptPay, merek kartu, dompet digital, atau kode sumber khusus.

5. Pilih kategori pembayaran eksternal Mews yang diaktifkan sebagai target.

6. Tambahkan baris lain hanya untuk metode sumber yang berbeda.

7. Klik Save.

   ✓ AVA memvalidasi setiap sumber yang dinormalisasi satu kali sebelum menyimpan. ✓ Posting Vouch berikutnya menggunakan kategori Mews yang dipilih.

Periksa kategori Mews terlebih dahulu

Kategori target harus diaktifkan untuk properti Anda di Mews. Minta administrator Mews mengaktifkannya sebelum menyimpan penggantian. Catatan pembayaran yang sudah ada tidak diubah oleh pemetaan baru.

Menghapus penggantian

Hapus baris sumber lalu simpan untuk mengembalikan perilaku posting default metode tersebut. Perubahan ini hanya memengaruhi posting Vouch berikutnya. Tinjau catatan yang sudah ada secara terpisah di Mews atau laporan akuntansi Anda.

Mengonfigurasi pemetaan metode pembayaran Furama

Gunakan pemetaan Furama saat pembayaran yang ditangkap harus menggunakan jenis pembayaran Furama iPMS yang aktif. Kartu pemetaan muncul untuk properti Furama yang terhubung dan mendukung penggantian pembayaran.

1. Pastikan Furama iPMS aktif di Settings → Essentials → PMS Integration.

2. Buka Settings → Payment.

3. Cari Payment method mappings.

4. Untuk setiap metode pembayaran, pilih jenis pembayaran Furama pada Record as. Metode kartu dipetakan berdasarkan merek, seperti Visa atau Amex. Metode non-kartu bernama dipetakan berdasarkan metode, seperti Cash.

5. Klik Save Payment Gateway Settings.

6. Jika perlu, atur Default payment type code (optional) di pengaturan Furama PMS.

7. Klik Save PMS Settings.

   ✓ Pemetaan eksplisit digunakan terlebih dahulu. ✓ Kode default menangani metode pembayaran tanpa pemetaan eksplisit. ✓ Tanpa salah satu pengaturan tersebut, AVA menolak pembayaran yang belum dipetakan sebelum mempostingnya.

Verifikasi kode Furama

Katalog Furama digunakan bersama di seluruh control unit dan dapat mencakup kode hotel lain. Pilih kode aktif yang telah dikonfirmasi oleh administrator Furama Anda.

Menghapus pemetaan Furama

Pilih Use default lalu simpan untuk menghapus penggantian metode pembayaran tersebut. Perubahan ini hanya memengaruhi posting berikutnya.

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
• ✅ Pre-authorization hold hanya tersimpan dengan jumlah deposit yang lebih besar dari 0
• ✅ 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

Pemecahan Masalah

Nilai pembayaran gagal divalidasi

Yang terlihat: AVA menandai kolom pembayaran sebagai tidak valid, atau MCP mengembalikan valid: false.

Perbaikan:

1. Gunakan tiga huruf kapital untuk Deposit Currency.

2. Masukkan nilai 0 atau lebih tinggi untuk Rounding Threshold.

3. Masukkan bilangan bulat 0 atau lebih tinggi untuk kode pembulatan dan jumlah hari kedaluwarsa.

4. Perbaiki kolom tersebut, lalu klik Save.

5. Untuk MCP, jalankan settings_validate lagi sebelum menerapkan pembaruan.

   ✓ Hasil validasi harus menampilkan valid: true sebelum Anda menyimpan atau menerapkan perubahan.

Pengaturan gateway dinonaktifkan

Yang terlihat: Sakelar 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.

Penyimpanan gateway Stripe manual ditolak

Yang terlihat: AVA menolak penyimpanan gateway Stripe manual.

Perbaikan:

1. Buka Settings → Payment → Payment Gateway Integration.

2. Atur Environment ke Test.

3. Isi ketiga kolom: Publishable Key, Secret Key, dan Webhook Secret.

4. Biarkan nilai yang disamarkan tetap tidak berubah saat menyimpan ulang kredensial yang sudah ada.

5. Simpan kembali pengaturan gateway pembayaran.

   ✓ AVA menyimpan konfigurasi test yang lengkap. ✓ Penyimpanan yang ditolak tidak mengganti kredensial Anda yang sudah ada.

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.

Opsi pemetaan Mews tidak tersedia

Yang terlihat: Kartu pemetaan Mews tidak ada, atau opsi sumber dan target tidak dimuat.

Perbaikan:

1. Pastikan Mews adalah PMS aktif.
2. Refresh Settings → Payment setelah Mews selesai dimuat.
3. Pastikan katalog pembayaran dan konfigurasi Mews tersedia.
4. Hubungi dukungan jika kartu tetap tidak tersedia.

AVA menonaktifkan perubahan sampai dapat memvalidasi opsi sumber dan target saat ini.

Kategori pembayaran Mews tidak tersedia

Yang terlihat: AVA menolak kategori pembayaran Mews yang dipilih.

Perbaikan:

1. Minta administrator Mews mengaktifkan kategori tersebut untuk properti.
2. Refresh Settings → Payment.
3. Pilih kategori yang diaktifkan dari daftar yang diperbarui.
4. Simpan pemetaan lagi.

Jangan mencoba kembali pembayaran sampai pemetaan berhasil disimpan.

Opsi pemetaan pembayaran Furama tidak tersedia

Yang terlihat: Kartu pemetaan Furama tidak ada, atau opsi pembayarannya tidak dimuat.

Perbaikan:

1. Pastikan Furama iPMS adalah PMS yang aktif.
2. Pastikan koneksi Furama telah disimpan.
3. Refresh Settings → Payment.
4. Periksa Control Unit di Settings → Essentials → PMS Integration.
5. Minta administrator Furama memastikan katalog pembayaran tersedia.

AVA menonaktifkan perubahan pemetaan sampai dapat membaca opsi sumber dan target saat ini.

Furama menolak jenis pembayaran

Yang terlihat: Furama menolak pembayaran setelah AVA mulai mempostingnya.

Perbaikan:

1. Refresh Payment method mappings.
2. Ganti target dengan jenis pembayaran Furama yang aktif.
3. Pastikan kode tersebut termasuk dalam control unit properti Anda.
4. Atur Default payment type code (optional) untuk metode yang belum dipetakan, jika diperlukan.
5. Simpan kedua halaman pengaturan.
6. Coba kembali pembayaran satu kali.

Jangan gunakan kode yang ditandai tidak aktif atau kode dari katalog properti lain.

Pemetaan pembayaran Opera hilang saat pembayaran

Yang terlihat: Pembayaran Opera tidak dapat dimulai karena pemetaan merek kartu tidak ada.

Mengapa ini terjadi: AVA mungkin belum memiliki daftar konfigurasi Opera bersama yang terbaru.

Perbaikan:

1. Tunggu sampai AVA menyelesaikan penyegaran konfigurasi otomatisnya.

2. Coba lagi pembayaran hanya jika AVA masih menampilkan kesalahan.

3. Periksa Opera PMS Payment Mapping di Settings → Payment.

4. Pastikan merek kartu memiliki kode metode pembayaran yang cocok.

5. Hubungi dukungan jika pemetaan ada tetapi pembayaran tetap tidak dapat dimulai.

   ✓ AVA melakukan penyegaran ini satu kali sebelum mengirim permintaan pembayaran Opera.

Daftar kode Opera kosong

Yang terlihat: Daftar kasir, settlement code, jenis komentar, lokasi komentar, atau metode pembayaran kosong.

Perbaikan:

1. Pastikan PMS aktif adalah Opera.
2. Periksa bahwa kode tersebut ada dan aktif di Opera.
3. Refresh Settings → Payment.
4. Pilih kode lain yang tersedia, jika sesuai.
5. Hubungi administrator Opera jika daftar tetap kosong.

AVA memuat setiap daftar secara terpisah. Kolom pemetaan lainnya tetap dapat dikonfigurasi.

Kode gagal dimuat dari OPERA

Yang terlihat: AVA menampilkan "Could not load codes from OPERA."

Perbaikan:

1. Pastikan Opera adalah PMS yang aktif.
2. Periksa bahwa koneksi Opera telah dikonfigurasi dan berfungsi.
3. Klik Try again di Opera PMS Payment Mapping.
4. Masukkan kode secara manual jika AVA tetap membiarkan kolom tersebut diedit.
5. Hubungi dukungan jika daftar tetap tidak tersedia.

Jika penyegaran gagal, AVA mempertahankan kode yang telah dibaca sebelumnya dan menampilkan peringatan penyegaran. Jika Opera mengembalikan respons parsial, AVA mempertahankan daftar yang berhasil dan menandai hanya daftar yang hilang sebagai tidak tersedia. Jangan mengganti pemetaan tersimpan yang valid kecuali Opera menandainya sebagai tidak tersedia.

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. Untuk ACI, pastikan Let assisted check-in staff collect payments aktif di Settings → Check-In → Check-In Policy → Kiosk & payments.
4. Pastikan reservasi memiliki saldo terutang.
5. Simpan dan uji lagi dengan reservasi contoh baru.

Sakelar khusus ACI

Sakelar ACI tidak mengubah permintaan pembayaran Self Check-In atau Pre-arrival.

Jumlah deposit nol tidak dapat disimpan

Yang terlihat: AVA menolak pengaturan pembayaran karena jumlah deposit kosong atau 0.

Mengapa ini terjadi: Pre-authorization hold memerlukan jumlah positif.

Perbaikan:

1. Buka Settings → Payment → Security Deposits & Incidentals.
2. Masukkan jumlah yang lebih besar dari 0 di Deposit Amount.
3. Klik Save Payment Gateway Settings.

Jika Anda tidak ingin menagih deposit, pilih Do not collect. Anda juga dapat mengeklik Switch to "Do not collect" instead pada kesalahan sebaris.

✓ AVA menyimpan pilihan pengumpulan yang aman dan berhenti meminta hold bernilai nol.

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
• ❌ Opsi pemetaan atau kategori pembayaran Mews tetap tidak tersedia
• ❌ Koneksi Stripe atau Red Dot berulang kali terputus

Sebaiknya sertakan:

• Tangkapan layar Settings → Payment
• Nama penyedia PMS
• ID reservasi dan stempel waktu contoh

Panduan Terkait

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