Requirement
Pastikan hal-hal dibawah sudah terpenuhi sebelum proses instalasi.
| Kebutuhan | Keterangan |
|---|---|
| PrestaShop | 9.1.x |
| PHP | Versi yang didukung resmi oleh rilis PrestaShop yang Anda pakai |
Ringkasan
- Pasang modul (lihat Instalasi).
- Buka Modules → Module Manager, cari Pakasir, lalu klik Configure.
- Klik Add a bank account dan isi detail rekening bank pertama (nama, pemilik rekening, nomor rekening, logo, dll).
- (Opsional) Batasi bank tersebut ke mata uang dan/atau negara tertentu lewat Restrict to currencies / Restrict to countries.
- Simpan, lalu ulangi untuk setiap rekening bank lain yang ingin ditampilkan (mis. Bank BCA, Bank Mandiri, Bank BNI).
- Pastikan modul memiliki mata uang aktif (lihat Mata uang). Tanpa seting ini, modul tidak akan tampil sama sekali dihalaman checkout.
- Atur pengaturan global (periode reservasi, tampilkan ajakan bayar di halaman konfirmasi) di bagian bawah halaman.
- 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 pakasir.zip. PrestaShop akan memasang modul secara otomatis.
Dari command line
unzip pakasir.zip -d modules/
php bin/console prestashop:module install pakasir
php bin/console cache:clear

Memverifikasi instalasi
Setelah terpasang, periksa:
- Modul Pakasir 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 → Pakasir → 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

| Kolom | Keterangan |
|---|---|
| Bank name | Nama bank, ditampilkan ke pelanggan (mis. “Bank BCA”). Wajib diisi. |
| Logo | Gambar yang tampil di samping nama bank saat checkout dan pada opsi pembayaran. Format PNG transparan direkomendasikan. |
| Account owner | Nama pemilik rekening. Wajib diisi. |
| Account number | Nomor rekening. |
| Branch | Cabang bank. |
| SWIFT / BIC | Kode SWIFT/BIC, untuk transfer internasional. |
| IBAN | Nomor IBAN, jika berlaku. |
| Account details | Informasi tambahan bebas yang perlu pelanggan untuk melakukan transfer. |
| Bank address | Alamat bank. |
| Information to the customer | Teks khusus per bahasa yang ditampilkan ke pelanggan saat checkout. |
| Restrict to currencies | Batasi bank ini agar hanya muncul untuk mata uang tertentu. Kosongkan untuk mengizinkan semua mata uang yang aktif. |
| Restrict to countries | Batasi bank ini agar hanya muncul untuk negara tertentu. Kosongkan untuk mengizinkan semua negara. |
| Enabled | Aktif/nonaktif rekening ini. Bank nonaktif tidak akan muncul di halaman checkout. |
Pengaturan umum
| Pengaturan | Default | Keterangan |
|---|---|---|
| Reservation period | 1 | Jumlah hari barang tetap direservasi menunggu pembayaran transfer masuk. |
| Display the invitation to pay in the order confirmation page | Aktif | Menampilkan detail rekening bank yang dipilih dan ajakan untuk membayar pada halaman konfirmasi pesanan. |
Alur pembayaran di checkout
- Pada saat pembayaran, pelanggan melihat satu opsi pembayaran per bank yang akif (sesuai dengan mata uang, dan negara di alamat penagihan).
- 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 → Pakasir → Uninstall. Proses ini akan:
- Menghapus konfigurasi modul.
Dari command line
php bin/console prestashop:module uninstall pakasir
php bin/console cache:clear
Troubleshooting
Modul tidak muncul sebagai opsi pembayaran
Urutan kemungkinan penyebab:
- Belum ada rekening bank yang ditambahkan sama sekali.
- Seluruh bank berstatus nonaktif.
- Modul belum diaktifkan untuk mata uang yang dipakai keranjang (lihat Mata uang modul).
- Semua bank yang aktif membatasi diri ke mata uang atau negara yang tidak cocok dengan keranjang/alamat penagihan pelanggan saat ini.
Changelog
| Versi | Perubahan |
|---|---|
| 1.0.0 | Rilis awal |