Integrasi Payment Gateway

Penyiapan Cepat

Atur gateway Anda terlebih dahulu. Lalu pilih tampilan billing dan aturan pembayaran. Sebagian besar hotel selesai dalam 5 menit.

Panduan ini membantu Anda mengatur pembayaran dan aturan tampilan billing di Settings → Payment. Jika Anda memakai Stripe, pilih Live atau Test sebelum menghubungkan. Waiver room-payment memeriksa komentar reservasi dan label sumber untuk kata kunci mandiri. Nama travel agent Opera seperti Booking.com (VCC) juga bisa memicu waiver yang sama. Pemilih sumber OTA lama sudah tidak lagi ada di halaman ini.

Lokasinya

Settings → Payment

Referensi Cepat

Area Pengaturan	Yang Dikendalikan	Hasil Utama
Billing View	Ringkasan billing tamu yang detail atau sederhana	Menampilkan baris itemized atau ringkasan yang lebih singkat
Payment Gateway Integration	Penyiapan Stripe atau Red Dot	Tamu bisa membayar di alur kiosk
Stripe Environment	Mode Live atau Test untuk gateway Stripe dan koneksi terminal	Terkunci setelah terhubung
Payment Collection Mode	Toggle deposit dan pembayaran penuh	Mengendalikan apa yang dibayar tamu saat check-in
Comment-Based Room Payment Waivers	Kata kunci waiver di komentar reservasi	Melewati blok saldo nol saat PMS Anda mendukung waiver berbasis kata kunci
Property Currency (di Settings → Essentials)	Mata uang yang diselesaikan untuk deposit dan tampilan pembayaran reservasi	Menjaga jumlah pembayaran tetap konsisten di seluruh pengaturan dan operasi
Deposit Currency	Mata uang yang dipakai untuk jumlah deposit di halaman ini	Disimpan bersama pengaturan pembayaran lain
Opera Payment Mapping	Pemetaan settlement, cashier, dan payment type	Opera menerima posting pembayaran dengan benar
Opera Payment Policy Controls	Logika rounding, pre-auth, hide, dan no-collect	Perilaku pembayaran khusus Opera ditegakkan

Sebelum Memulai

• Siapkan akun payment gateway Anda
• Tentukan apakah Anda ingin tampilan billing Detailed atau Simplified
• Tentukan apakah Anda ingin deposit, pembayaran penuh, atau keduanya
• Konfirmasi kebijakan deposit dan sumber mata uang properti Anda di Settings → Essentials → Hotel Basic Details
• Pastikan versi PMS Anda secara eksplisit mendukung kata kunci waiver pembayaran. Jika AVA tidak bisa mengonfirmasi dukungan, field tetap tersembunyi.
• Jika Anda memakai Opera, siapkan mapping cashier ID dan payment method code Anda

Penyiapan Langkah demi Langkah

Langkah 1: Pilih Payment Gateway

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 onboarding Stripe.
5. Kembali ke Streamliner dan pastikan Stripe terhubung.

Mode Stripe

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

Setup terminal Stripe juga default ke Live kecuali Anda mengubahnya sebelum menghubungkan.

Checkout terminal

Saat sebuah kiosk hanya punya satu terminal Stripe yang dipetakan, AVA membukanya otomatis saat checkout. Saat lebih dari satu terminal dipetakan, Anda memilih dari terminal picker di modal pembayaran. Jika mode terminal mati, AVA mempertahankan alur gateway atau pembayaran QR.

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: Pilih Billing View

Gunakan kartu ini untuk mengontrol ringkasan billing yang dilihat tamu. Pilih Detailed untuk baris itemized. 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 payment.

Langkah 3: Pilih Opsi Pengumpulan Pembayaran

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

1. Nyalakan salah satu atau keduanya.
2. Jika keduanya mati, check-in tidak meminta pembayaran.
3. Klik Save Payment Gateway Settings.

Langkah 4: Konfigurasikan Detail Deposit (Jika Diaktifkan)

1. Masukkan Deposit Amount.
2. Pilih Deposit Type (per night atau flat amount).
3. Jika Anda melihat Deposit Currency, pilih mata uang yang dipakai hotel untuk deposit.
4. Klik Save Payment Gateway Settings.

Sumber mata uang deposit

Pengaturan pembayaran memakai Property Currency yang diselesaikan dari Settings → Essentials → Hotel Basic Details. Jika PMS menyediakan mata uang, AVA memakai nilai itu dan mengunci edit lokal. Deposit Currency yang Anda pilih disimpan bersama pengaturan pembayaran lainnya.

Waiver Pembayaran Kamar Berdasarkan Komentar

Gunakan ini saat AVA harus melewati pembayaran kamar dari waiver kata kunci PMS yang didukung.

• Tetapkan satu kata kunci waiver di Payment Policy Controls.
• AVA memeriksa komentar reservasi dan label sumber untuk kata kunci itu.
• Opera juga meneruskan nama profil travel agent ke pencocokan yang sama.
• Jika kata kunci cocok sebagai kata sendiri, AVA melewati blok pembayaran.
• Jika hanya muncul di dalam token yang lebih panjang, AVA tetap menganggap saldo harus dibayar.
• Jika tidak cocok, AVA tetap menganggap saldo dapat ditagih.

Label sumber Opera

Jika Opera mengembalikan label travel agent, AVA bisa membaca nilai seperti Booking.com (VCC). Label itu bisa memenuhi kata kunci waiver.

Perilaku waiver universal

Saat AVA tidak bisa mengonfirmasi dukungan waiver berbasis kata kunci, editor tetap tersembunyi. Cloudbeds, eZee, Ava, Furama, vendor tak dikenal, dan versi PMS yang tidak didukung tidak menampilkan field ini.

1. Buka Payment Policy Controls.
2. Masukkan kata kunci waiver yang ditulis PMS Anda ke komentar reservasi.
3. Klik Save.
4. Uji dengan reservasi yang menyertakan kata kunci itu.

Langkah 5: Konfigurasikan Pemetaan Pembayaran Opera (Hanya Opera)

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 dengan satu kode metode pembayaran OPERA. AVA menyimpan baris ini bersama pengaturan pembayaran Anda yang lain.

Default komentar pembayaran Opera

AVA mengirim Default Comment Type / Location yang sudah Anda konfigurasi saat membuat komentar pembayaran atau deposit Opera. Simpan mapping lagi setelah mengubah nilai ini.

Langkah 6: Konfigurasikan Opera Payment Policy Controls (Hanya Opera)

1. Di Opera Payment Policy Controls, atur perilaku pembayaran:
   • Visibilitas invoice dan verifikasi checkout
   • Penyesuaian rounding dan transaction code
   • Opsi auto delay capture
   • Daftar aturan hide dan no-collect
2. Klik Save Payment Policies.

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 menjaga pengumpulan pembayaran tetap berjalan meski pembuatan komentar Opera gagal. Aturan waiver kamar universal dikonfigurasi di atas.

Yang Diharapkan Setelah Disimpan

• ✅ Detail gateway yang terhubung muncul setelah penyiapan
• ✅ Stripe menampilkan Live atau Test pada badge status terhubung
• ✅ Billing view tersimpan bersama pengaturan pembayaran lainnya
• ✅ Field deposit muncul saat deposit diaktifkan
• ✅ Deposit currency tetap tersimpan setelah Anda klik Save
• ✅ Bagian Opera mapping dan Opera policy hanya muncul untuk Opera PMS
• ✅ Kartu Step 3: Configure Opera PMS Payment Mapping muncul saat active PMS provider adalah Opera
• ✅ Pengaturan pembayaran tersimpan secara independen di halaman yang sama

Catatan migrasi

Penyiapan pembayaran berpindah dari Settings → Essentials ke Settings → Payment. Pemilih sumber OTA lama sudah dihapus.

Pemecahan Masalah

Pengaturan gateway dinonaktifkan

Yang terlihat: Toggle pembayaran atau tombol simpan dinonaktifkan.

Perbaikan:

1. Pastikan akun Anda punya 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 layout 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 salah, pastikan hotel memakai jalur pengaturan CCI yang 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 Stripe lagi.

Bagian Opera tidak muncul

Yang terlihat: Kartu mapping dan policy Opera hilang.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan PMS provider adalah Opera.
3. Kembali ke Settings → Payment.
4. Refresh halaman sekali.
5. Pastikan Step 3: Configure Opera PMS Payment Mapping muncul.

Pemetaan pembayaran Opera tidak tersimpan

Yang terlihat: Baris cashier atau payment method hilang setelah Anda klik Save.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan Opera masih menjadi PMS aktif.
3. Kembali ke Settings → Payment.
4. Masukkan lagi Default Cashier ID dan setiap baris pemetaan.
5. Klik lagi Save Opera Payment Mapping.

Komentar reservasi Opera hilang

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

Perbaikan:

1. Konfirmasi Default Comment Type / Location sudah diatur di Opera PMS Payment Mapping.
2. Periksa bahwa reservasi Opera memiliki record pembayaran yang cocok.
3. Pastikan Default Comment Type / Location sudah diatur di Opera PMS Payment Mapping.
4. Jangan coba ulang hanya untuk membuat komentar lagi.
5. Hubungi support jika pembayaran sudah diposting dan komentar tetap tidak muncul.

Tipe atau lokasi komentar Opera terlihat salah

Yang Anda lihat: 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 mapping lagi.
5. Uji pembayaran atau deposit Opera lain.

Pembayaran kamar di-waive tanpa sengaja

Yang Anda lihat: 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 kata kunci jika reservasi seharusnya tidak di-waive.
4. Refresh AVA dan uji lagi dengan reservasi baru.

Field kata kunci waiver pembayaran hilang

Yang Anda lihat: Anda tidak melihat field kata kunci waiver, atau Anda melihat pesan PMS yang tidak didukung di Payment Policy Controls.

Perbaikan:

1. Pastikan provider PMS Anda mendukung keyword waiver.
2. Refresh Settings → Payment.
3. Jika field masih tidak muncul, AVA belum punya data dukungan untuk PMS itu.
4. Pertahankan kata kunci waiver yang sudah ada. AVA tetap menyimpannya meski editor tersembunyi.

Baris billing tidak cocok dengan PMS

Yang Anda lihat: Baris room, pajak, deposit, atau incidental terlihat berbeda di AVA.

Perbaikan:

1. Konfirmasi reservasi berasal dari PMS yang mendukung aturan billing AVA.
2. Jika Anda memakai Opera, tunggu sinkron reservasi berikutnya.
3. Refresh Settings → Payment atau buka ulang reservasi.
4. Periksa bill di PMS untuk memastikan apakah baris tersebut disembunyikan atau di-waive.

Tamu tidak diminta membayar

Yang Anda lihat: 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 yang harus dibayar.
4. Simpan dan uji lagi dengan reservasi contoh.

Deposit currency terlihat salah atau tidak bisa diedit

Yang Anda lihat: Deposit currency tidak cocok dengan pengaturan yang Anda harapkan, atau perubahan field tidak bertahan.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.
2. Periksa apakah Property Currency dikelola PMS atau bisa diedit.
3. Jika dikelola PMS, perbarui currency di PMS dan tunggu sinkron.
4. Refresh Settings → Payment dan verifikasi currency.

Pengaturan Terkait

• Kebijakan Check-In
• Koneksi PMS
• Integrasi PMS Opera

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Pembayaran masih gagal setelah Anda menyimpan ulang pengaturan
• ❌ Perubahan billing view tidak muncul untuk tamu
• ❌ Nilai mapping Opera tidak bertahan
• ❌ Koneksi Stripe atau Red Dot berulang kali terputus

Informasi yang membantu untuk disertakan:

• Screenshot Settings → Payment
• Nama provider PMS
• Contoh reservation ID dan stempel waktu