Integrasi Payment Gateway

Pengaturan Cepat

Atur payment gateway Anda terlebih dahulu. Lalu atur aturan deposit dan kebijakan pembayaran Opera. Sebagian besar hotel menyelesaikannya dalam 5 menit.

Panduan ini membantu Anda mengatur aturan penagihan pembayaran pada halaman pengaturan Payment yang baru.

Lokasi

Settings → Payment

Referensi Cepat

Area Pengaturan	Yang Dikendalikan	Hasil Utama
Payment Gateway Integration	Penyiapan Stripe atau Red Dot	Tamu dapat membayar di alur kiosk
Payment Collection Mode	Toggle deposit dan pembayaran penuh	Mengontrol apa yang dibayar tamu saat check-in
Property Currency (di Settings → Essentials)	Mata uang terselesaikan untuk deposit dan tampilan pembayaran reservasi	Menjaga konsistensi nominal pembayaran di pengaturan dan operasional
Opera Payment Mapping (Step 3 card)	Pemetaan settlement, cashier, jenis pembayaran	Opera menerima posting pembayaran dengan benar
Opera Payment Policy Controls	Pembulatan, pre-auth, logika waive/hide	Perilaku pembayaran khusus Opera diterapkan

Sebelum Memulai

• Siapkan akun payment gateway Anda
• Tentukan apakah Anda ingin deposit, pembayaran penuh, atau keduanya
• Konfirmasi kebijakan deposit dan sumber property currency di Settings → Essentials → Hotel Basic Details
• Jika memakai Opera, siapkan nilai cashiering dan payment mapping Anda

Penyiapan Langkah demi Langkah

Langkah 1: Pilih Payment Gateway

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

Untuk Stripe

1. Klik Connect Stripe.
2. Selesaikan onboarding Stripe.
3. Kembali ke Streamliner lalu pastikan Stripe terhubung.

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 Opsi Penagihan Pembayaran

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

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

Langkah 3: Konfigurasikan Detail Deposit (Jika Diaktifkan)

1. Masukkan Deposit Amount.
2. Pilih Deposit Type (per malam atau jumlah tetap).
3. Klik Save Payment Gateway Settings.

Sumber mata uang deposit

Pengaturan pembayaran memakai Property Currency terselesaikan dari Settings → Essentials → Hotel Basic Details. Jika PMS menyediakan mata uang, AVA memakai nilai tersebut dan mengunci edit lokal.

Langkah 4: Konfigurasikan Opera Payment Mapping (Khusus Opera)

1. Pada 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.

Langkah 5: Konfigurasikan Opera Payment Policy Controls (Khusus Opera)

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

Yang Diharapkan Setelah Disimpan

• ✅ Detail gateway terhubung muncul setelah penyiapan
• ✅ Field deposit muncul saat deposit diaktifkan
• ✅ Bagian mapping Opera dan kebijakan Opera 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 pada halaman yang sama

Catatan Migrasi

Penyiapan pembayaran dipindahkan 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 pengaturan.
2. Hubungkan Stripe terlebih dahulu jika Stripe dipilih.
3. Muat ulang halaman lalu coba lagi.

Bagian Opera tidak muncul

Yang Anda lihat: Kartu mapping Opera dan policy tidak ada.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan provider PMS adalah Opera.
3. Kembali ke Settings → Payment.
4. Muat ulang halaman sekali.
5. Pastikan Step 3: Configure Opera PMS Payment Mapping 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 lalu uji ulang dengan reservasi contoh.

Mata uang deposit terlihat salah atau tidak dapat diedit

Yang Anda lihat: Mata uang deposit tidak sesuai pengaturan yang diharapkan, atau perubahan field 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 lalu tunggu sinkronisasi.
4. Muat ulang Settings → Payment lalu verifikasi mata uang.

Pengaturan Terkait

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

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Pembayaran tetap gagal setelah menyimpan ulang pengaturan
• ❌ Nilai mapping Opera tidak tersimpan
• ❌ Koneksi Stripe atau Red Dot berulang kali terputus

Informasi yang sebaiknya disertakan:

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