README

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

该库允许

在<img>标签中显示包含二维码的图片，该图片的src属性是data-uri，因此不需要将生成的图片存储在服务器上（$qrInvoice->getQRCodeImage()）
保存带有二维码的图片（$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 bonami/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
二进制

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

显示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
分支自 - https://github.com/miskith/QRInvoice

贡献

我非常欢迎任何改进建议，无论是通过issue还是pull request。

bonami / qr-platba

维护者

详细信息