Download the PHP package ardhikaxx/qris-dynamic-gateway without Composer
On this page you can find all versions of the php package ardhikaxx/qris-dynamic-gateway. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ardhikaxx/qris-dynamic-gateway
More information about ardhikaxx/qris-dynamic-gateway
Files in ardhikaxx/qris-dynamic-gateway
Package qris-dynamic-gateway
Short Description Enterprise QRIS EMVCo parser and generator for Laravel
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package qris-dynamic-gateway
QRIS Dynamic Gateway (Laravel Package)
Laravel Package berskala Enterprise yang dirancang khusus untuk memproses, memvalidasi, dan melakukan manipulasi (generate) standar QRIS EMVCo Indonesia.
Library ini sangat berguna untuk mengubah QRIS Statis (yang mengharuskan pelanggan mengetik nominal manual) menjadi QRIS Dinamis (nominal sudah otomatis terisi saat di-scan) hanya melalui satu baris kode, sehingga mempermudah integrasi sistem kasir (POS), billing, dan e-commerce di ekosistem Laravel Anda.
🌟 Penjelasan Fitur Lengkap
1. QRIS EMVCo Parser (Pemecah String QRIS)
String QRIS mentah terdiri dari ratusan karakter acak berdasarkan format EMVCo internasional (contoh: 000201010211...).
- Fungsi: Library ini membaca karakter rumit tersebut dan memecahnya menggunakan standar Tag, Length, Value (TLV).
- Hasil: String mentah secara instan diterjemahkan menjadi Array Object PHP. Anda bisa dengan sangat mudah mengambil informasi rahasia di baliknya seperti Nama Toko (Merchant Name), Kota, maupun ID Merchant dari QRIS apa pun tanpa perlu melakukan pemotongan string secara manual.
2. QRIS Dynamic Generator (Injeksi Nominal Otomatis)
Ini adalah fungsi sentral (Core) dari package ini.
- Fungsi: Menyuntikkan nominal tagihan ke dalam QRIS toko Anda. Anda cukup memberikan string QRIS toko biasa (Statis), dan package ini akan:
- Menyisipkan Transaction Amount (Tag 54).
- Mengubah indikator metode inisiasi (Tag 01) dari
11(Statis) menjadi12(Dinamis).
- Hasil: Sebuah string QRIS baru yang siap dibentuk menjadi gambar Barcode/QR Code. Saat pelanggan memindainya lewat M-Banking/E-Wallet, nominal tagihan akan langsung terisi.
3. Mesin Kriptografi CRC16 CCITT-False (Keamanan)
Keamanan adalah nyawa dari transaksi finansial. Di ujung setiap kode QRIS terdapat 4 karakter checksum keamanan.
- Fungsi: Package ini dibekali kalkulator keamanan bawaan yang diwajibkan oleh Bank Indonesia (Algoritma CRC16 CCITT-False).
- Hasil: Saat library ini mengubah nominal, ia akan otomatis menghitung dan menyematkan 4 digit keamanan baru. Hal ini memastikan QRIS yang dihasilkan dianggap Legal dan valid oleh sistem perbankan. Library ini juga otomatis menolak (throw Exception) apabila mencoba memproses QRIS palsu/rusak.
4. Integrasi Mulus di Ekosistem Laravel
Dirancang 100% dengan gaya programming Laravel yang modern.
- Fungsi: Mendukung Laravel 10, 11, 12, dan 13. Dilengkapi Service Provider dan Facade bawaan.
- Hasil: Anda tidak perlu memanggil class yang panjang. Cukup panggil
Qris::generateDynamic()di dalam controller manapun, dan library ini bekerja otomatis di latar belakang (Plug and Play).
📦 Kebutuhan Sistem (Requirements)
- PHP >= 8.2
- Laravel >= 10.0 (Support Laravel 13)
🚀 Instalasi
Anda dapat menginstal package ini melalui Composer. Buka terminal proyek Laravel Anda dan jalankan:
(Catatan Pengembang: Jika Anda menghubungkannya ke repositori lokal, pastikan mendaftarkan symlink/path repository di composer.json).
📖 Cara Penggunaan (Usage)
Setelah terinstal, Facade Qris dapat langsung digunakan di mana saja.
1. Mengekstrak Data dari QRIS Statis (Parsing)
Berguna untuk memeriksa validitas QRIS dan mendapatkan data spesifik dari string QRIS hasil scan.
2. Mengubah QRIS Statis menjadi Dinamis (Generation)
Sangat ideal digunakan pada aplikasi Kasir/POS atau saat Checkout E-commerce, di mana pelanggan harus membayar nilai spesifik yang sudah ditentukan sistem.
Tip: Gabungkan hasil dari $dynamicQris dengan library seperti simplesoftwareio/simple-qrcode untuk merendernya menjadi gambar .png atau .svg di dalam view Blade Anda.
3. Debugging via Terminal (Artisan Command)
Anda bisa membedah (analyze) string QRIS langsung dari terminal untuk keperluan debugging dengan perintah bawaan:
Ini akan mencetak tabel rapi yang berisi Merchant Name, Transaction Amount, dan semua tag yang terekstrak beserta validitas CRC16-nya.
🧪 Pengujian (Testing)
Package ini dirancang untuk level Enterprise dan telah teruji ketat (Unit Testing) mematuhi kalkulasi perbankan. Untuk menjalankan seluruh test suite secara mandiri:
💖 Dukungan & Donasi
Jika library ini bermanfaat bagi Anda dan telah menghemat banyak jam kerja Anda, Anda dapat menunjukkan apresiasi dengan memberikan traktiran kopi (donasi) melalui pemindaian kode QRIS di bawah ini:
📝 Lisensi
Proyek ini bersifat open-source dan didistribusikan di bawah Lisensi MIT.
