jorklo/swiss-qr-bill

A PHP library to create Swiss QR bills

dev-master 2022-10-07 17:57 UTC

Requires

• php: ^8.0.0|^8.1.0
• ext-dom: *
• endroid/qr-code: ^4.4.4
• kmukku/php-iso11649: ^1.5
• symfony/intl: ^4.4|^5.0|^6.0
• symfony/polyfill-intl-icu: ^1.23
• symfony/validator: ^4.4|^5.0|^6.0

Requires (Dev)

• dg/bypass-finals: ^1.3
• dms/phpunit-arraysubset-asserts: ^0.2
• fpdf/fpdf: ^1.82
• friendsofphp/php-cs-fixer: ^3.4
• khanamiryan/qrcode-detector-decoder: ^1.0.3
• phpstan/phpstan: ^1.2
• phpunit/phpunit: ^9.0
• setasign/fpdf: ^1.8.2
• setasign/fpdi: ^2.3.5
• tecnickcom/tcpdf: ^6.3.2

Suggests

• fpdf/fpdf: Needed to create pdfs with FpdfOutput
• setasign/fpdf: Needed to create pdfs with Fpdi
• setasign/fpdi: Needed to create pdfs with Fpdi
• tecnickcom/tcpdf: Needed to create pdfs with TcPdfOutput

Conflicts

• khanamiryan/qrcode-detector-decoder: 1.0.6

MIT

README

A PHP library to create Swiss QR Bill payment parts (QR-Rechnung) which fully replaced the red and orange payment slips by September 30, 2022.

Getting started

composer require jorklo/swiss-qr-bill

Then have a look at example/example.php.

FAQs

• Why is my IBAN not working?
  A typical QR bill (example) requires a special QR IBAN. You can get yours from your bank. A classic IBAN can be used for QR bills with a SCOR reference (example) or no reference number at all (example).

• How do I recognize a QR IBAN?
  See https://github.com/jorklo/php-swiss-qr-bill/issues/182#issuecomment-1229539977

• How do I create QR bills for international IBANs?
  You can't. The QR bill by specification only supports IBANs from Switzerland and Liechtenstein.

• How do I support currencies other than CHF or EUR?
  You can't. The QR bill by specification only supports CHF and EUR.

• How do I make my QR bills payable by Twint?
  See https://github.com/jorklo/php-swiss-qr-bill/issues/129

• What PDF libraries are supported by this library?
  The following libraries are currently actively supported:

  • fpdf/fpdf
  • tecnickcom/tcpdf
  • setasign/fpdi (accepted by FpdfOutput and TcPdfOutput)

  The output of HtmlOutput has been known to be used to generate PDFs with PrinceXML, Docraptor or dompdf/dompdf (with some adjustments as decribed here)

Getting help

Do you need more help using this library?

• Search the existing and closed issues to see if you find your answer there.
• If you still need help, you may create an issue yourself to ask your question.

Please note that the maintainer of this library will not provide any support by email. The beauty of open source software lies in the fact that everybody can benefit from each other. Therefore questions will only be answered in public.

Versioning

Semantic versioning is used for this library.

In addition, a minor version will always be published if any visible change in the output of the qr code or the payment part takes place, even if it could be considered to be just a bugfix.

Support the project

• Do you like this project? Consider a Github sponsorship.
• Would you like to contribute? Have a look at the open issues. Be nice to each other.
• Spread the word!

Official resources

The repository contains the official specifications the library is based on:

• Swiss Implementation Guidelines QR-bill
• Technical information about the QR-IID and QR-IBAN
• Style Guide QR-bill
• Validation Tool

For more official information about the new standards see

• https://www.paymentstandards.ch/de/shared/communication-grid.html
• https://www.six-group.com/interbank-clearing/en/home/standardization/payment-slips.html