AgenWebsite Payments

Instalasi Plugin

Langkah 1: Mengunduh Plugin

  1. Kunjungi halaman akun AgenWebsite di https://www.agenwebsite.com/account
  2. Unduh file plugin AgenWebsite Payments dalam format .zip

Langkah 2: Mengunggah Plugin ke WordPress

  1. Masuk ke Dashboard WordPress Admin
  2. Navigasi ke menu Plugins > Add New
  3. Klik tombol Upload Plugin di bagian atas halaman
  4. Klik Choose File dan pilih file .zip yang telah diunduh
  5. Klik Install Now

Langkah 3: Mengaktifkan Plugin

  1. Setelah instalasi selesai, klik tombol Activate Plugin
  2. Plugin akan aktif dan menu AgenWebsite Payments akan muncul di sidebar admin

Aktivasi Lisensi

Sebelum dapat menggunakan fitur-fitur plugin, Anda harus mengaktifkan lisensi terlebih dahulu.

Langkah Aktivasi Lisensi

  1. Navigasi ke menu AgenWebsite Payments di sidebar admin WordPress
  2. Pada halaman pengaturan awal, Anda akan melihat form input kode lisensi
  3. Mendapatkan Kode Lisensi:
    • Jika belum memiliki lisensi, klik tombol Daftar Lisensi Gratis untuk mendaftarkan lisensi gratis
    • Jika sudah memiliki lisensi, kunjungi https://www.agenwebsite.com/account untuk mendapatkan kode lisensi Anda
  4. Masukkan kode lisensi pada kolom Kode Lisensi
  5. Klik tombol Aktifkan Lisensi
  6. Jika berhasil, sistem akan menampilkan pesan “Pengaturan berhasil disimpan” dan Anda akan diarahkan ke halaman pengaturan utama

Deaktivasi Lisensi

Jika Anda perlu memindahkan lisensi ke instalasi lain:

  1. Buka halaman AgenWebsite Payments > Settings
  2. Klik tombol Deaktivasi
  3. Konfirmasi dengan mengklik Ya, Nonaktifkan Lisensi pada modal konfirmasi


Fitur-Fitur Utama

Setelah lisensi aktif, Anda dapat mengakses pengaturan melalui:

  • Navigasi: Dashboard Admin > AgenWebsite Payments

Halaman pengaturan memiliki navigasi sidebar dengan tiga tab utama:

  • Payment Codes – Fitur kode pembayaran unik
  • Payment Confirmation – Upload bukti pembayaran (PRO)
  • Indonesian Banks – Transfer bank Indonesia (PRO)


Fitur Kode Pembayaran

Tujuan Fitur

Fitur Payment Codes menghasilkan kode pembayaran unik 3 digit yang ditambahkan atau dikurangi dari total pembayaran. Kode ini memudahkan verifikasi transfer bank dengan mengidentifikasi setiap transaksi berdasarkan angka unik pada total pembayaran.

Dashboard Admin > AgenWebsite Payments > Payment Codes

Pengaturan yang Tersedia

Pengaturan Kode Pembayaran
Pengaturan Deskripsi
Aktifkan Kode Pembayaran Checkbox untuk mengaktifkan/menonaktifkan fitur kode pembayaran unik 3 digit
Label Kode Pembayaran Teks label yang ditampilkan untuk kode pembayaran di halaman checkout dan order (default: “Kode Pembayaran”)
Metode Pembayaran Pilih metode pembayaran mana yang akan menggunakan kode pembayaran (multi-select)
Metode Pengurangan Jika dicentang, kode pembayaran akan dikurangi dari total order. Jika tidak, akan ditambahkan
Pengaturan Generasi Kode
Pengaturan Deskripsi
Pola Generasi Kode Pilihan metode generate kode: Acak (kode acak dalam rentang), Nomor HP (3 digit terakhir telepon), Kode Pos (3 digit pertama kode pos)
Rentang Angka Acak Rentang angka untuk kode acak dalam format min-max (contoh: 100-999). Hanya berlaku jika pola “Acak” dipilih
Pengaturan Tampilan
Pengaturan Deskripsi
Tampilkan di Thank You Page Checkbox untuk menampilkan kode pembayaran di halaman terima kasih
Pesan Thank You Page Pesan yang ditampilkan. Gunakan {payment_code} untuk menampilkan kode pembayaran
Tampilkan di Email Checkbox untuk menyertakan kode pembayaran dalam email order
Pesan Email Pesan yang dikirimkan via email. Gunakan {payment_code} untuk menampilkan kode pembayaran

Contoh Konfigurasi

Label: Kode Pembayaran
Pola: Acak
Rentang: 100-999
Metode: Tambahkan ke total

Hasil: Total pembayaran Rp 1.500.000 akan menjadi Rp 1.500.357 (dengan kode unik 357).


Fitur Konfirmasi Pembayaran

Catatan: Fitur ini hanya tersedia untuk lisensi PRO.

Tujuan Fitur

Fitur Payment Confirmation memungkinkan pelanggan untuk mengunggah bukti pembayaran/transfer setelah melakukan pemesanan. Fitur ini mempercepat proses verifikasi pembayaran karena admin dapat langsung melihat bukti transfer yang diunggah pelanggan.

Dashboard Admin > AgenWebsite Payments > Payment Confirmation

Pengaturan yang Tersedia

Pengaturan Konfirmasi Pembayaran
Pengaturan Deskripsi
Aktifkan Konfirmasi Pembayaran Checkbox untuk mengaktifkan fitur upload bukti pembayaran
Judul Halaman Upload Judul yang ditampilkan di halaman upload konfirmasi pembayaran
Deskripsi Deskripsi yang ditampilkan di halaman upload
Pengaturan Upload File
Pengaturan Deskripsi
Ukuran Maksimal File Ukuran maksimal file dalam MB (1-50 MB)
Tipe File yang Diizinkan Pilih tipe file yang dapat diupload (JPG, JPEG, PNG, GIF, PDF, DOC, DOCX)
Pengaturan Email
Pengaturan Deskripsi
Notifikasi Admin Kirim email ke admin saat ada upload baru
Notifikasi Pelanggan Kirim email konfirmasi ke pelanggan setelah upload
Tampilkan di Email Order Sertakan instruksi upload di email order
Pesan Email Pesan yang ditampilkan di email order
Notifikasi Bulk Aktifkan notifikasi email untuk aksi bulk
Pengaturan Tampilan
Pengaturan Deskripsi
Tampilkan di Thank You Page Tampilkan form upload di halaman terima kasih
Pesan Thank You Page Pesan yang ditampilkan di halaman terima kasih
Pengaturan Otomasi
Pengaturan Deskripsi
Ubah Status Otomatis Mengubah status order secara otomatis saat bukti pembayaran diupload
Status Setelah Upload Status order setelah bukti pembayaran diupload (default: On Hold)
Update Status Saat Approve Ubah status order otomatis saat konfirmasi disetujui
Status Setelah Disetujui Status order setelah konfirmasi pembayaran disetujui (default: Processing)
Metode Pembayaran Metode pembayaran yang memerlukan konfirmasi (BACS, Cheque, COD)
Media Library Menyimpan file yang diupload ke WordPress Media Library

Mengelola Konfirmasi Pembayaran (Admin)

Halaman Daftar Konfirmasi

Navigasi: Dashboard Admin > AgenWebsite Payments > Payment Confirmations

Halaman ini menampilkan semua konfirmasi pembayaran yang telah diupload pelanggan dengan informasi:

  • Nomor Order
  • Nama Pelanggan
  • Total Order
  • Tanggal Upload
  • Status Konfirmasi
Menyetujui/Menolak Konfirmasi
  1. Buka order yang memiliki konfirmasi pembayaran
  2. Pada sidebar order, temukan meta box Payment Confirmation
  3. Anda dapat melihat:
    • Status konfirmasi
    • Preview gambar bukti pembayaran
    • Tombol View File untuk melihat file lengkap
    • Tanggal upload
    • Catatan pelanggan
  1. Untuk menyetujui, klik tombol Approve
  2. Untuk menolak, klik tombol Reject dan berikan alasan penolakan
Aksi Bulk

Anda dapat menyetujui atau menolak beberapa konfirmasi sekaligus:

  1. Centang konfirmasi yang ingin diproses
  2. Pilih aksi bulk dari dropdown
  3. Klik Apply

Fitur Transfer Bank Indonesia

Catatan: Fitur ini hanya tersedia untuk lisensi PRO.

Tujuan Fitur

Fitur Indonesian Banks menambahkan metode pembayaran transfer bank Indonesia ke WooCommerce. Pelanggan dapat memilih bank yang tersedia saat checkout dan menerima instruksi pembayaran yang lengkap dengan nomor rekening.

Dashboard Admin > AgenWebsite Payments > Indonesian Banks

Pengaturan yang Tersedia

Pengaturan Transfer Bank Indonesia
Pengaturan Deskripsi
Aktifkan Indonesian Bank Transfer Checkbox untuk mengaktifkan metode pembayaran transfer bank Indonesia
Judul Metode Pembayaran Judul yang ditampilkan kepada pelanggan saat checkout (default: “Transfer Bank”)
Deskripsi Metode Pembayaran Deskripsi yang ditampilkan kepada pelanggan saat checkout
Pemilihan Bank

Pilih bank mana yang akan ditampilkan kepada pelanggan. Bank tersedia dalam kategori:

Bank Konvensional:

  • BCA, BRI, Mandiri, BNI, BTN, CIMB Niaga, Danamon, OCBC NISP, Panin, Permata, Mega, Maybank Indonesia, UOB Indonesia, Commonwealth, Bukopin, Sinarmas, DBS Indonesia, KEB Hana

Bank Syariah:

  • Muamalat, BCA Syariah, BRI Syariah, Syariah Mandiri, BNI Syariah, BTN Syariah, Mega Syariah, CIMB Niaga Syariah, dan lainnya

Bank Daerah (BPD):

  • BJB, DKI, Jateng, Jatim, BPD DIY, BPD Bali, Bank Sumut, Bank Nagari, dan bank daerah lainnya

Bank Asing:

  • ANZ Indonesia, Artha Graha, ICBC Indonesia, Mizuho Indonesia, dan lainnya

Cara memilih bank:

  1. Klik pada logo bank yang ingin diaktifkan
  2. Bank yang dipilih akan ditandai (logo berwarna penuh)
  3. Bank yang tidak dipilih akan terlihat transparan
Pengaturan Order
Pengaturan Deskripsi
Status Order Default Status order awal ketika pelanggan memilih pembayaran transfer bank (On Hold atau Processing)
Template Instruksi Pembayaran Template pesan instruksi. Gunakan placeholder: [BANK_NAME], [ORDER_TOTAL], [ORDER_ID]
Konfigurasi Rekening Bank

Setelah memilih bank, Anda perlu mengkonfigurasi nomor rekening untuk setiap bank:

  1. Bagian konfigurasi rekening akan muncul untuk setiap bank yang dipilih
  2. Untuk setiap bank, masukkan:
    • Nomor Rekening – Nomor rekening bank
    • Nama Pemilik Rekening – Nama pemilik rekening sesuai buku tabungan
  1. Klik Add Account untuk menambah rekening lain pada bank yang sama
  2. Klik Remove untuk menghapus rekening

Mengaktifkan Gateway di WooCommerce

Setelah konfigurasi di AgenWebsite Payments, aktifkan juga di pengaturan WooCommerce:

  1. Navigasi ke WooCommerce > Settings > Payments
  2. Temukan Indonesian Bank Transfer
  3. Pastikan toggle dalam posisi aktif

Tampilan Checkout

  1. Memilih Metode Pembayaran:
    • Saat checkout, pelanggan akan melihat opsi “Transfer Bank”
    • Pelanggan memilih bank pilihan dari grid bank yang tersedia
  1. Menyelesaikan Order:
    • Setelah memilih bank, klik “Place Order”
    • Pelanggan akan diarahkan ke halaman Thank You
  2. Melihat Instruksi Pembayaran:
    Pada halaman Thank You, pelanggan akan melihat:

    • Nama bank yang dipilih
    • Nomor rekening tujuan transfer
    • Nama pemilik rekening
    • Total yang harus ditransfer (termasuk kode pembayaran jika aktif)
    • Tombol copy untuk menyalin nomor rekening dan jumlah

Upload Bukti Pembayaran

Dari Halaman Thank You:

  1. Setelah melakukan transfer, klik tombol Upload Bukti Pembayaran
  2. Modal upload akan muncul
  1. Drag and drop file bukti transfer atau klik untuk browse file
  2. Tipe file yang diizinkan: JPG, PNG, GIF, PDF (sesuai pengaturan admin)
  3. Maksimal ukuran file sesuai pengaturan admin
  4. Tambahkan catatan tambahan jika diperlukan
  5. Klik Submit Payment Confirmation

Dari Halaman My Account:

  1. Login ke akun
  2. Navigasi ke My Account > Orders
  3. Temukan order yang ingin dikonfirmasi
  4. Klik tombol Upload Bukti Pembayaran
  1. Ikuti langkah upload seperti di atas

Dari Halaman Detail Order:

  1. Buka detail order dari My Account
  2. Scroll ke bagian bawah detail order
  3. Klik tombol Upload Bukti Pembayaran

Melihat Status Konfirmasi

Setelah mengupload bukti pembayaran:

  1. Buka detail order dari My Account
  2. Status konfirmasi akan ditampilkan:
    • Pending Review – Menunggu review admin
    • Approved – Konfirmasi disetujui
    • Rejected – Konfirmasi ditolak (dengan alasan penolakan)

Kode Pembayaran

Jika fitur kode pembayaran aktif:

  1. Total pembayaran akan memiliki 3 digit unik
  2. Pelanggan harus mentransfer tepat sesuai nominal yang ditampilkan
  3. Informasi kode pembayaran ditampilkan di:
    • Halaman checkout
    • Halaman Thank You
    • Email konfirmasi order

Email Notifikasi

Pelanggan akan menerima email yang berisi:

  • Detail order
  • Instruksi pembayaran dengan nomor rekening
  • Link untuk upload bukti pembayaran
  • Kode pembayaran (jika aktif)

Troubleshooting

Masalah Umum dan Solusi

1. Plugin Tidak Muncul Setelah Instalasi

Penyebab:

  • Instalasi tidak sempurna
  • Konflik dengan plugin lain

Solusi:

  • Pastikan WooCommerce sudah terinstall dan aktif (minimal versi 9.0.0)
  • Nonaktifkan plugin lain sementara untuk mengecek konflik
  • Reinstall plugin

2. Lisensi Tidak Dapat Diaktifkan

Penyebab:

  • Kode lisensi salah
  • Lisensi sudah digunakan di website lain
  • Masalah koneksi ke server AgenWebsite

Solusi:

  • Periksa kembali kode lisensi dari halaman akun AgenWebsite
  • Deaktivasi lisensi dari website sebelumnya jika perlu dipindahkan
  • Cek koneksi internet dan coba lagi

3. Metode Pembayaran Indonesian Banks Tidak Muncul di Checkout

Penyebab:

  • Fitur belum diaktifkan
  • Tidak ada bank yang dipilih
  • Lisensi bukan PRO

Solusi:

  1. Pastikan lisensi PRO sudah aktif
  2. Buka AgenWebsite Payments > Indonesian Banks
  3. Centang Aktifkan Indonesian Bank Transfer
  4. Pilih minimal satu bank
  5. Konfigurasi nomor rekening untuk bank yang dipilih
  6. Aktifkan juga di WooCommerce > Settings > Payments

4. Upload Bukti Pembayaran Gagal

Penyebab:

  • Ukuran file melebihi batas
  • Tipe file tidak diizinkan
  • Masalah permission folder upload

Solusi:

  • Periksa pengaturan ukuran maksimal file di Payment Confirmation settings
  • Pastikan tipe file sesuai dengan yang diizinkan
  • Pastikan folder wp-content/uploads memiliki permission yang benar (755 atau 775)

5. Kode Pembayaran Tidak Muncul

Penyebab:

  • Fitur tidak diaktifkan
  • Metode pembayaran tidak dipilih

Solusi:

  1. Buka AgenWebsite Payments > Payment Codes
  2. Centang Aktifkan Kode Pembayaran
  3. Pilih metode pembayaran yang akan menggunakan kode pembayaran
  4. Simpan perubahan

6. WooCommerce Blocks Compatibility Warning

Penyebab:

  • Halaman checkout menggunakan WooCommerce Blocks (Gutenberg editor)

Solusi:

  • Install plugin tambahan AgenWebsite Payments – WooCommerce Blocks Integration
  • Download dari halaman akun AgenWebsite
  • Atau gunakan checkout classic (non-blocks)

7. Email Notifikasi Tidak Terkirim

Penyebab:

  • Pengaturan email WordPress tidak benar
  • Masalah server email

Solusi:

  • Pastikan pengaturan notifikasi aktif di Payment Confirmation settings
  • Install plugin SMTP seperti WP Mail SMTP untuk pengiriman email yang lebih reliable
  • Cek log email jika tersedia