README

PHP 生成 QR 支付的库。QR 支付简化了最终用户执行支付命令的过程，因为它包含所有必要的数据，只需扫描即可。现在可以使用除 CZK 以外的其他货币，通过方法 setCurrenty($currency)。

该库允许

在 <img> 标签中显示图像，其中包含 QR 代码的 data-uri，因此生成的图像无需存储在服务器上（$qrInvoice->getQRCodeImage()）
存储 QR 代码图像（$qrInvoice->saveQRCodeImage()）
获取 data-uri（$qrInvoice->getQRCodeImage(false)）
获取 QrCode 实例（$qrInvoice->getQRCodeInstance()）

当前支持以下银行的 QR 支付：Air Bank、Česká spořitelna、ČSOB、Equa bank、Era、Fio banka、Komerční banka、mBank、Raiffeisenbank、ZUNO。

支持 PHP ^7.3||^8.0。

使用 Composer 安装

composer require miskith/qr-platba

QR 支付示例

<?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

可以使用更简单的语法

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

QR 发票和支付示例

<?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

QR 发票示例（仅发票，无支付）

<?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

其他选项

保存到文件

// 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);

当前可能支持的格式有

Png
Svg
Pdf
Eps
二进制

对于其他格式，需要编写自定义的 Writter

显示 data-uri

// data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAAFAAQMAAAD3XjfpAAAA...
echo $qrInvoice->getQRCodeImage(false);

链接

文档 - https://www.davidmyska.com/qr-invoice/
QR 支付官方网站 - https://qr-platba.cz/
QR 发票官方网站 - https://qr-faktura.cz/
原始项目 - https://github.com/dfridrich/QRPlatba
为原始开发者提供灵感 - https://github.com/snoblucha/QRPlatba

贡献

我很乐意接受任何改进建议，无论是 issue 还是 pull request。

miskith / qr-platba

维护者

详细信息