Menerima pembayaran QRIS melalui QRISLY (RajaOngkir/Komerce). Cara kerja QRISLY unik, dimana Anda mengunggah QRIS statis sekali saja, lalu modul ini memanggil API QRISLY secara real-time untuk menghasilkan QRIS dinamis sesuai nominal untuk setiap pesanan, dan menampilkannya langsung di halaman checkout.
Requirement
Pastikan hal-hal dibawah sudah terpenuhi sebelum proses instalasi.
| Kebutuhan | Keterangan |
|---|---|
| PrestaShop | >= 8.0 |
| PHP | Versi yang didukung resmi oleh rilis PrestaShop yang Anda pakai |
| Akun QRISLY | API Key dari dashboard RajaOngkir |
Cara kerja
- Merchant mengunggah gambar QRIS statis sekali di halaman konfigurasi modul. Jika berhasil, data yang dikirim dari QRISLY seperti
qris_iddsb, akan disimpan di konfigurasi. - Customer memilih “Pay with QRISLY (QRIS)” saat checkout, browser diarahkan ke halaman sendiri (bukan redirect ke website pihak ketiga).
- Di halaman tersebut QRIS dinamis akan dibuat berdasarkan total keranjang belanja dan QR ditampilkan di sisi client. QR yang ditampilkan memiliki tenggat waktu pembayaran.
- Jika pembayaran selesai dan QRISLY mengkonfirmasikan pembayaran via webhook dan nominalnya cocok, pesanan kemudian dibuatkan secara otomatis dan browser diarahkan ke halaman konfirmasi pesanan.
Instalasi
Dari Back Office
- Salin modul ini ke
modules/qrislypada instalasi PrestaShop Anda. - Install melalui back office: Modules → Module Manager → QRISLY Payment (QRIS) → Install.
- Konfigurasikan (lihat di bawah) sebelum mengaktifkannya untuk customer.
Dari command line
unzip qrisly.zip -d modules/
php bin/console prestashop:module install qrisly
php bin/console cache:clearMemverifikasi instalasi
Setelah terpasang, periksa:
- Modul QRISLY Payment (QRIS) muncul di Modules → Module Manager dengan status aktif, pada tab Payments.
- Membuka Configure menampilkan form pengaturan.
Konfigurasi
Buka Modules → Module Manager → QRISLY Payment (QRIS) → Configure.
Pengaturan
| Field | Wajib | Catatan |
|---|---|---|
| Mode | Ya | Sandbox (https://api-sandbox.collaborator.komerce.id/user) atau Production (https://api.collaborator.komerce.id/user). Menentukan base URL yang dipakai untuk setiap pemanggilan API. |
| API key | Ya | Dihasilkan dari dashboard QRISLY Anda. Dikirim disetiap request. |
| Unique amount | Tidak (default: aktif) | QRISLY akan menambahkan digit pengenal kecil pada nominal (mis. Rp 1.000 -> Rp 1.003) agar setiap nilai transaksi menjadi unik. Dikenakan biaya Rp100 dari sisi QRISLY untuk setiap QRIS yang dihasilkan. |
| Webhook URL | — (read-only, dihasilkan otomatis) | Opsional. Salin ke dashboard QRISLY pada Webhook → QRISLY → Outbound Webhook agar konfirmasi pembayaran lebih cepat. |
Pilih juga mata uang mana saja yang tersedia untuk metode pembayaran ini, pada layar konfigurasi yang sama (fitur standar pembatasan mata uang modul pembayaran PrestaShop).
Unggah QRIS statis
Di bawah form pengaturan, unggah gambar QRIS statis milik merchant Anda (PNG/JPG, maks 5MB) beserta nama identitas (maks 100 karakter). Mengunggah ulang akan mengganti QRIS yang dipakai untuk semua pesanan berikutnya.
Saat QRIS sudah dikonfigurasi, tombol Delete QRIS akan ditampilkan. Tombol ini hanya menghapus nilai konfigurasi yang disimpan.
Uninstall
Dari Back Office
Buka Modules → Module Manager → QRISLY Payment (QRIS) → Uninstall. Proses ini akan menghapus seluruh konfigurasi modul.
Dari command line
php bin/console prestashop:module uninstall qrisly
php bin/console cache:clearDISCLAIMER (Ketergantungan pada layanan pihak ketiga)
Modul ini terintegrasi dengan layanan pihak ketiga QRISLY (RajaOngkir/Komerce). Pemrosesan pembayaran, harga, uptime, dan perilaku API sepenuhnya dikendalikan oleh QRISLY, bukan oleh modul ini atau pengembangnya. Jika QRISLY mengubah API-nya, menghentikan layanan, atau mengalami downtime, pembayaran melalui modul ini akan gagal sampai QRISLY memulihkan layanannya atau modul ini diperbarui agar sesuai dengan API yang baru. Pengembang modul ini tidak bertanggung jawab atas ketersediaan layanan, praktik keamanan, atau kelangsungan bisnis QRISLY, dan tidak memberikan jaminan bahwa QRISLY akan terus beroperasi.
Changelog
| Versi | Perubahan |
|---|---|
| 1.0.0 | Rilis awal. |