All-in-One Bank Wire

Requirement

Pastikan hal-hal dibawah sudah terpenuhi sebelum proses instalasi.

Ringkasan

1. Pasang modul (lihat Instalasi).
2. Buka Modules → Module Manager, cari All-in-One Bank Wire, lalu klik Configure.
3. Klik Add a bank account dan isi detail rekening bank pertama (nama, pemilik rekening, nomor rekening, logo, dll).
4. (Opsional) Batasi bank tersebut ke mata uang dan/atau negara tertentu lewat Restrict to currencies / Restrict to countries.
5. Simpan, lalu ulangi untuk setiap rekening bank lain yang ingin ditampilkan (mis. Bank BCA, Bank Mandiri, Bank BNI).
6. Pastikan modul memiliki mata uang aktif (lihat Mata uang). Tanpa seting ini, modul tidak akan tampil sama sekali dihalaman checkout.
7. Atur pengaturan global (periode reservasi, tampilkan ajakan bayar di halaman konfirmasi) di bagian bawah halaman.
8. Buat order baru untuk testing dan pastikan bank yang sesuai tampil sebagai opsi pembayaran di checkout.

Instalasi

Dari Back Office

Buka Modules → Module Manager → Upload a module lalu pilih file aiobankwire.zip. PrestaShop akan memasang modul secara otomatis, tetapi module ini tidak otomatis aktif untuk mata uang manapun — lihat Mata uang modul setelah instalasi.

Dari command line

unzip aiobankwire.zip -d modules/
php bin/console prestashop:module install aiobankwire
php bin/console cache:clear

Apa yang terjadi saat instalasi

Modul tidak membuat satu pun rekening bank saat instalasi. Daftar bank dimulai kosong, dan harus ditambahkan manual dari halaman Configure.

Memverifikasi instalasi

Setelah terpasang, periksa:

• Modul All-in-One Bank Wire muncul di Modules → Module Manager dengan status aktif.
• Membuka Configure menampilkan daftar bank (secara default akan kosong) beserta tombol Add a bank account.
• Jika modul aktif tapi belum ada bank, atau belum ada mata uang yang diaktifkan untuknya, akan muncul peringatan (warning) pada baris modul di Module Manager.

Konfigurasi

Semua pengaturan modul berada di satu halaman: Modules → Module Manager → All-in-One Bank Wire → Configure.

Daftar bank

Bagian atas halaman menampilkan rekening bank yang sudah dibuat, dengan logo, nama, dan status aktif/nonaktif, serta tombol aksi:

• Edit — membuka form ubah data bank.
• Delete — menghapus data bank beserta file logonya.
• Toggle status — mengaktifkan/menonaktifkan bank tanpa menghapusnya.

Klik Add a bank account untuk menambah rekening baru.

Form tambah/ubah bank

Mata uang

Selain pembatasan per bank, modul secara keseluruhan juga harus diaktifkan untuk minimal satu mata uang (currencies_mode berbentuk checkbox, sama seperti modul pembayaran PrestaShop pada umumnya). Ini diatur di tab Currencies pada halaman konfigurasi modul, bukan di form bank.

Pengaturan umum

Alur pembayaran di checkout

1. Pada saat pembayaran, pelanggan melihat satu opsi pembayaran per bank yang akif (sesuai dengan mata uang, dan negara di alamat penagihan).
2. Memilih salah satu bank akan menampilkan konfirmasi berisi detail rekening bank tersebut sebelum pesanan dibuat.

Pengujian sebelum go-live

• Tambahkan minimal dua bank berbeda, tanpa pembatasan apa pun, dan pastikan keduanya tampil dihalaman checkout.
• Nonaktifkan salah satu bank dan pastikan opsi tersebut hilang dari checkout, tapi masih tampil di daftar admin.
• Batasi satu bank ke mata uang tertentu dan tes dengan keranjang belanja di mata uang lain. Bank tersebut harus tidak muncul.
• Batasi satu bank ke negara tertentu dan uji dengan alamat penagihan di negara lain. Bank tersebut harusnya tidak muncul.
• Selesaikan satu pesanan, lalu ubah nama/hapus bank yang dipakai. Pastikan halaman konfirmasi pesanan dan email tetap menampilkan detail bank yang benar-benar dipilih saat checkout.
• Upload logo, ganti logo pada bank yang sama.
• Pastikan modul menampilkan warning di Module Manager saat belum ada bank aktif, atau belum ada mata uang yang diaktifkan.

Uninstall

Dari Back Office

Buka Modules → Module Manager → All-in-One Bank Wire → Uninstall. Proses ini akan:

• Menghapus tabel database milik modul. Seluruh data rekening bank ikut terhapus.
• Menghapus konfigurasi modul (periode reservasi, flag ajakan bayar).

Dari command line

php bin/console prestashop:module uninstall aiobankwire
php bin/console cache:clear

Troubleshooting

Modul tidak muncul sebagai opsi pembayaran

Urutan kemungkinan penyebab:

1. Belum ada rekening bank yang ditambahkan sama sekali.
2. Seluruh bank berstatus nonaktif.
3. Modul belum diaktifkan untuk mata uang yang dipakai keranjang (lihat Mata uang modul).
4. Semua bank yang aktif membatasi diri ke mata uang atau negara yang tidak cocok dengan keranjang/alamat penagihan pelanggan saat ini.

Bank tertentu tidak muncul padahal sudah aktif

Periksa Restrict to currencies dan Restrict to countries pada bank tersebut — kosongkan salah satu atau keduanya jika seharusnya tidak ada batasan.

Logo tidak tampil / gagal diunggah

Periksa ukuran file (maksimum 2MB) dan format gambar. Jika error menyebut penyimpanan gagal, pastikan direktori views/img/banks/ dapat ditulis oleh web server.

Changelog