Integrasi Payment Gateway

Pengaturan Cepat

Atur payment gateway Anda terlebih dahulu. Setelah itu, atur aturan deposit dan kebijakan pembayaran Opera. Sebagian besar hotel selesai dalam 5 menit.

Panduan ini membantu Anda mengatur aturan pengumpulan pembayaran di halaman pengaturan Payment yang baru. Jika Anda menggunakan Stripe, pilih Live atau Test sebelum menghubungkan.

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
Stripe Environment	Mode Live atau Test untuk gateway Stripe dan koneksi terminal	Terkunci setelah terhubung
Payment Collection Mode	Toggle deposit dan pembayaran penuh	Mengatur apa yang dibayar tamu saat check-in
Property Currency (di Settings → Essentials)	Mata uang yang terselesaikan untuk deposit dan tampilan pembayaran reservasi	Menjaga nominal pembayaran tetap konsisten di seluruh pengaturan dan operasi
Deposit Currency	Mata uang yang digunakan untuk nominal deposit di halaman ini	Tersimpan bersama pengaturan pembayaran lainnya
Opera Payment Mapping (Step 3 card)	Pemetaan settlement, cashier, payment type	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 Anda di Settings → Essentials → Hotel Basic Details
• Jika menggunakan Opera, siapkan ID cashier dan pemetaan payment method 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 production dan Test untuk onboarding sandbox. Setelah Stripe terhubung, environment menjadi read-only sampai Anda memutuskan sambungan.

Penyiapan Stripe untuk terminal juga secara default menggunakan Live kecuali Anda mengubahnya sebelum menghubungkan.

Checkout terminal

Saat kiosk memiliki satu terminal Stripe yang dipetakan, AVA akan membukanya otomatis selama checkout. Jika ada lebih dari satu terminal yang dipetakan, Anda memilih dari terminal picker di modal pembayaran. Jika mode terminal nonaktif, AVA mempertahankan alur pembayaran gateway atau 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 Opsi Pengumpulan Pembayaran

Toggle	Fungsinya
Collect Security Deposits	Melakukan pre-authorize deposit saat check-in
Collect Full Payment	Tamu membayar sisa saldo 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. Jika Anda melihat Deposit Currency, pilih mata uang yang digunakan hotel Anda untuk deposit.
4. Klik Save Payment Gateway Settings.

Sumber mata uang deposit

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

Langkah 4: Konfigurasikan Opera Payment Mapping (Khusus 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 OPERA payment method. AVA menyimpan baris ini bersama pengaturan pembayaran lainnya.

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

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

Komentar pembayaran Opera

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

Yang Diharapkan Setelah Disimpan

• ✅ Detail gateway yang terhubung muncul setelah penyiapan
• ✅ Stripe menampilkan Live atau Test pada badge status terhubung
• ✅ Field deposit muncul saat deposit diaktifkan
• ✅ Mata uang deposit tetap tersimpan setelah Anda klik Save
• ✅ Bagian mapping Opera 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

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 untuk pengaturan.
2. Hubungkan Stripe terlebih dahulu jika Stripe dipilih.
3. Refresh halaman lalu coba lagi.

Environment Stripe terkunci

Yang Anda lihat: Dropdown Environment dinonaktifkan setelah Stripe terhubung.

Perbaikan:

1. Putuskan sambungan 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 tidak ada.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.
2. Pastikan provider PMS 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 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 lagi Save Opera Payment Mapping.

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. Ulangi pembayaran hanya jika kebijakan hotel Anda mengizinkannya.
4. Hubungi support jika pembayaran sukses dan 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.

Mata uang deposit terlihat salah atau tidak dapat diedit

Yang Anda lihat: Mata uang deposit tidak sesuai 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 dapat diedit.
3. Jika dikelola PMS, perbarui mata uang di PMS lalu tunggu sinkronisasi.
4. Refresh Settings → Payment dan verifikasi mata uangnya.

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
• ❌ 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