Integrasi Payment Gateway

Pengaturan 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 menyambungkan.

Di Mana Menemukannya

Settings → Payment

Referensi Cepat

Area Pengaturan	Yang Dikendalikan	Hasil Utama
Billing View	Ringkasan billing tamu yang detail atau disederhanakan	Menampilkan baris itemized atau ringkasan yang lebih singkat
Payment Gateway Integration	Setup Stripe atau Red Dot	Tamu dapat membayar di alur kiosk
Stripe Environment	Mode Live atau Test untuk gateway Stripe dan koneksi terminal	Terkunci setelah tersambung
Payment Collection Mode	Toggle deposit dan full payment	Mengontrol apa yang dibayar tamu saat check-in
Property Currency (di Settings → Essentials)	Mata uang yang diselesaikan untuk deposit dan tampilan pembayaran reservasi	Menjaga nominal pembayaran konsisten di semua pengaturan dan operasi
Deposit Currency	Mata uang yang dipakai untuk nominal deposit di halaman ini	Disimpan bersama pengaturan pembayaran lainnya
Opera Payment Mapping	Pemetaan settlement, cashier, dan payment type	Opera menerima posting pembayaran dengan benar
Opera Payment Policy Controls	Aturan rounding, pre-auth, waive, dan hide	Perilaku pembayaran khusus Opera diterapkan

Sebelum Anda Mulai

• Siapkan akun payment gateway Anda
• Tentukan apakah Anda ingin tampilan billing Detailed atau Simplified
• Tentukan apakah Anda ingin deposit, full payment, atau keduanya
• Konfirmasi kebijakan deposit dan sumber currency properti Anda di Settings → Essentials → Hotel Basic Details
• Jika memakai Opera, siapkan cashier ID dan pemetaan payment method code Anda

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 production dan Test untuk onboarding sandbox. Setelah Stripe terhubung, environment menjadi read-only sampai Anda memutusnya.

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

Checkout terminal

Saat sebuah kiosk punya satu terminal Stripe yang dipetakan, AVA akan membukanya otomatis saat checkout. Saat ada lebih dari satu terminal yang dipetakan, Anda memilih dari terminal picker di modal pembayaran. Jika mode terminal mati, AVA tetap memakai 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.

Penempatan billing view

Kartu ini muncul sebelum Terminal Payment Configuration di halaman payment.

Langkah 3: Pilih Opsi Koleksi 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 satu atau kedua toggle.
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 currency yang dipakai hotel untuk deposit.
4. Klik Save Payment Gateway Settings.

Sumber deposit currency

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

Langkah 5: Konfigurasikan Opera Payment Mapping (Hanya Opera)

1. Di Step 3: Configure 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 mapping

Setiap baris menghubungkan satu payment method ke satu kode payment method OPERA. AVA menyimpan baris ini bersama pengaturan pembayaran lainnya.

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

1. Di Opera Payment Policy Controls, atur perilaku pembayaran:
   • visibilitas invoice dan verifikasi checkout
   • rounding adjustment dan transaction code
   • opsi auto delay capture
   • daftar aturan waive, hide, dan no-collect
2. Klik Save Payment Policies.

Komentar pembayaran Opera

Setelah pembayaran atau posting deposit Opera berhasil, AVA menambahkan komentar reservasi di Opera. Ini terjadi otomatis dan tidak mengubah hasil pembayaran di Streamliner.

Yang Perlu Diharapkan Setelah Save

• ✅ Detail gateway yang terhubung muncul setelah setup
• ✅ Stripe menampilkan Live atau Test di 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 mapping dan policy Opera hanya muncul untuk PMS Opera
• ✅ 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

Setup pembayaran pindah dari Settings → Essentials ke Settings → Payment.

Pemecahan Masalah

Pengaturan gateway dinonaktifkan

Yang Anda lihat: Toggle pembayaran atau tombol simpan dinonaktifkan.

Perbaikan:

1. Pastikan akun Anda memiliki akses tulis settings.
2. Hubungkan Stripe terlebih dahulu jika Stripe dipilih.
3. Muat ulang halaman dan coba lagi.

Billing view tidak berubah

Yang Anda lihat: 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 muat ulang layar reservasi.
5. Jika masih terlihat salah, pastikan hotel memakai jalur settings CCI yang sekarang.

Environment Stripe terkunci

Yang Anda lihat: Dropdown Environment dinonaktifkan setelah Stripe terhubung.

Perbaikan:

1. Putuskan Stripe.
2. Buka Advanced.
3. Pilih Live atau Test.
4. Sambungkan Stripe lagi.

Bagian Opera tidak muncul

Yang Anda lihat: Kartu mapping dan policy Opera hilang.

Perbaikan:

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

Pemetaan pembayaran Opera tidak tersimpan

Yang Anda lihat: 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 ulang Default Cashier ID dan setiap baris mapping.
5. Klik Save Opera Payment Mapping lagi.

Komentar reservasi Opera hilang

Yang Anda lihat: 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 apakah reservasi Opera memiliki record pembayaran yang cocok.
3. Coba ulang pembayaran hanya jika kebijakan hotel Anda mengizinkannya.
4. Hubungi support jika pembayaran terposting tetapi komentar masih tidak muncul.

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 terutang.
4. Simpan dan uji ulang 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 tersimpan.

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. Muat ulang Settings → Payment dan verifikasi currency.

Pengaturan Terkait

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

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Pembayaran masih gagal setelah menyimpan ulang pengaturan
• ❌ Perubahan billing view tidak muncul untuk tamu
• ❌ Nilai mapping Opera tidak bertahan