bonami / qr-platba
Generování QR plateb a faktur v PHP.
Requires
- php: ^7.3||^8.0
- endroid/qr-code: ^4.2.1
Requires (Dev)
- phpunit/phpunit: ^9.5.6
README
Knihovna pro generování QR plateb v PHP. QR platba zjednodušuje koncovému uživateli
provedení příkazu k úhradě, protože obsahuje veškeré potřebné údaje, které stačí jen
naskenovat. Nově lze použít i jiné měny než CZK a to pomocí metody setCurrenty($currency)
.
Tato knihovna umožňuje:
- zobrazení obrázku v
<img>
tagu, který obsahuje vsrc
rovnou data-uri s QR kódem, takže vygenerovaný obrázek tak není třeba ukládat na server ($qrInvoice->getQRCodeImage()
) - uložení obrázku s QR kódem (
$qrInvoice->saveQRCodeImage()
) - získání data-uri (
$qrInvoice->getQRCodeImage(false)
) - získání instance objektu QrCode (
$qrInvoice->getQRCodeInstance()
)
QRPlatbu v současné době podporují tyto banky: Air Bank, Česká spořitelna, ČSOB, Equa bank, Era, Fio banka, Komerční banka, mBank, Raiffeisenbank, ZUNO.
Podporuje PHP ^7.3||^8.0.
Instalace pomocí Composeru
composer require bonami/qr-platba
Příklad QR platby
<?php require __DIR__ . '/vendor/autoload.php'; use miskith\QRInvoice\QRInvoice; $qrInvoice = (new QRInvoice) ->setAccount('12-3456789012/0100') ->setVariableSymbol('2016001234') ->setMessage('Toto je první QR platba.') ->setSpecificSymbol('0308') ->setSpecificSymbol('1234') ->setCurrency('CZK') // Výchozí je CZK, lze zadat jakýkoli ISO kód měny ->setDueDate(new \DateTime()); echo $qrInvoice->getQRCodeImage(); // Zobrazí <img> tag s kódem, viz níže
Lze použít i jednodušší zápis:
echo QRInvoice::create('12-3456789012/0100', 987.60) ->setMessage('QR platba je parádní!') ->getQRCodeImage();
Příklad QR faktury a platby v jednom
<?php require __DIR__ . '/vendor/autoload.php'; use miskith\QRInvoice\QRInvoice; $qrInvoice = QRInvoice::create('27-16060243/0300', 495.00, '012150672') ->setInvoiceId('012150672') ->setDueDate(new \DateTime('2015-12-17')) ->setInvoiceDate(new \DateTime('2015-12-01')) ->setTaxDate(new \DateTime('2015-12-01')) ->setTaxPerformance(0) ->setCompanyTaxId('CZ60194383') ->setCompanyRegistrationId('60194383') ->setInvoiceSubjectTaxId('CZ12345678') ->setTaxBase(409.09, 0) ->setTaxAmount(85.91, 0); echo $qrInvoice->getQRCodeImage(); // Zobrazí <img> tag s kódem, viz níže
Příklad QR faktury (pouze faktura bez platby)
<?php require __DIR__ . '/vendor/autoload.php'; use miskith\QRInvoice\QRInvoice; $qrInvoice = (new QRInvoice) ->setIsOnlyInvoice(true) ->setIban('CZ9701000000007098760287+KOMBCZPP') ->setAmount(61189.00) ->setVariableSymbol('3310001054') ->setInvoiceId('2001401154') ->setInvoiceDocumentType(9) ->setDueDate(new \DateTime('2018-04-12')) ->setInvoiceDate(new \DateTime('2014-04-04')) ->setTaxDate(new \DateTime('2014-04-04')) ->setTaxPerformance(0) ->setCompanyTaxId('CZ25568736') ->setCompanyRegistrationId('25568736') ->setInvoiceSubjectTaxId('CZ25568736') ->setInvoiceSubjectRegistrationId('25568736') ->setMessage('Dodávka vybavení interiéru hotelu Kamzík') ->setTaxBase(26492.70, 0) ->setTaxAmount(5563.47, 0) ->setTaxBase(25333.10, 1) ->setTaxAmount(3799.97, 1) ->setNoTaxAmount(-0.24) ->setInvoiceIncludingDeposit(false); echo $qrInvoice->getQRCodeImage(); // Zobrazí <img> tag s kódem, viz níže
Další možnosti
Uložení do souboru
// Uloží png o velikosti 100x100 px $qrInvoice->saveQRCodeImage('qrcode.png', 'png', 100); // Uloží svg o velikosti 100x100 px s 10 px marginem $qrInvoice->saveQRCodeImage('qrcode.svg', 'svg', 100, 10);
Aktuální možné formáty jsou:
- Png
- Svg
- Eps
- binární
Pro další je potřeba dopsat vlastní Writter
Zobrazení data-uri
// data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAAFAAQMAAAD3XjfpAAAA... echo $qrInvoice->getQRCodeImage(false);
Odkazy
- Dokumentace - https://www.davidmyska.com/qr-invoice/
- Oficiální web QR Platby - https://qr-platba.cz/
- Oficiální web QR Faktury - https://qr-faktura.cz/
- Originální projekt - https://github.com/dfridrich/QRPlatba
- Inspirace pro originálního developera - https://github.com/snoblucha/QRPlatba
- Forknuto z - https://github.com/miskith/QRInvoice
Contributing
Budu rád za každý návrh na vylepšení ať už formou issue nebo pull requestu.