QR Platba a QR Faktura

, _(*1)

, _(*2)

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)., _(*3)

Tato knihovna umožňuje:, _(*4)

zobrazení obrázku v <img> tagu, který obsahuje v src rovnou data-uri s QR kódem, takže vygenerovaný obrázek tak není třeba ukládat na server ($qrPlatba->getQRCodeImage())
uložení obrázku s QR kódem ($qrPlatba->saveQRCodeImage())
získání data-uri ($qrPlatba->getDataUri())
získání instance objektu QrCode ($qrPlatba->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., _(*5)

Podporuje PHP 7.4 až 8.1., _(*6)

Instalace pomocí Composeru

composer require "dfridrich/qr-platba:^2", _(*7)

Příklad

<?php

require __DIR__ . '/vendor/autoload.php';

use Defr\QRPlatba\QRPlatba;

$qrPlatba = new QRPlatba();

$qrPlatba->setAccount('12-3456789012/0100') // nastavení č. účtu
    ->setIBAN('CZ3112000000198742637541') // nastavení č. účtu
    ->setVariableSymbol('2016001234')
    ->setMessage('Toto je první QR platba.')
    ->setConstantSymbol('0308')
    ->setSpecificSymbol('1234')
    ->setAmount('1234.56')
    ->setCurrency('CZK') // Výchozí je CZK, lze zadat jakýkoli ISO kód měny
    ->setDueDate(new \DateTime());

echo $qrPlatba->getQRCodeImage(); // Zobrazí <img> tag s kódem, viz níže

Ukázky (viz test/OutputTest.php), zkuste si je naskenovat v bankovnictví nebo třeba iDokladu jako QR Fakturu:, _(*8)

QR Platba (PNG):
, _(*9)

QR Platba v EUR (PNG):
, _(*10)

QR Platba (SVG):
, _(*11)

QR Platba a popisek (PNG):
, _(*12)

QR Platba a popisek v EUR (PNG):
, _(*13)

QR Platba a popisek (SVG):
, _(*14)

QR Platba+F a popisek (PNG):
, _(*15)

QR Platba+F a popisek v EUR (PNG):
, _(*16)

QR Platba+F a popisek (SVG):
, _(*17)

QR Faktura bez platby (SVG):
, _(*18)

Lze použít i jednodušší zápis:, _(*19)

echo QRPlatba::create('12-3456789012/0100', 987.60)
    ->setMessage('QR platba je parádní!')
    ->getQRCodeImage();

Pro IBAN pak:, _(*20)

echo QRPlatba::create('CZ6508000000192000145399', 987.60)
    ->setMessage('QR platba je parádní!')
    ->getQRCodeImage();

Další možnosti

Uložení do souboru, _(*21)

// Uloží png o velikosti 100x100 px
$qrPlatba->saveQRCodeImage("qrcode.png", "png", 100);

// Uloží svg o velikosti 100x100 px
$qrPlatba->saveQRCodeImage("qrcode.svg", "svg", 100);

// Generování jen QR Faktury
$qrPlatba->setIsOnlyInvoice(true)->setLabel('QR Faktura');

Aktuální možné formáty jsou: * PNG * SVG, _(*22)

Pro další je potřeba dopsat vlastní Writer, _(*23)

Zobrazení data-uri, _(*24)

// data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAAFAAQMAAAD3XjfpAAAA...
echo $qrPlatba->getDataUri();

Odkazy

Oficiální web QR Platby - http://qr-platba.cz/
Oficiální web QR Faktury - http://qr-faktura.cz/
Repozitář, který mě inspiroval - https://github.com/snoblucha/QRPlatba
Fork, ze kterého jsem zpětně přidal a upravil implementaci QR Faktury - https://github.com/bonami/qr-platba
Image by storyset on Freepik