php swiss qr bill

瑞士二维码账单

用于创建瑞士 QR 账单支付部件 ( QR-Rechnung ) 的 PHP 库。

入门

 composer require sprain/swiss-qr-bill

然后看一下 example/example.php。

常见问题解答

• 为什么我的 IBAN 不起作用？
  典型的 QR 账单（示例）需要特殊的 QR IBAN。您可以从银行获取您的。经典 IBAN 可用于具有 SCOR 参考号（示例）或根本没有参考号（示例）的 QR 帐单。

• 我如何识别 QR IBAN？
  在 QR IBAN 中，机构 id在第 5 到第 9 个字符中定义，是 30000 到 31999 范围内的数字。（示例：CH44 3199 9 123 0008 8901 2）。如何在代码中检测它，请参见#182（评论）

• 如何为国际 IBAN 创建 QR 帐单？
  你不能。根据规范，QR 法案仅支持来自瑞士和列支敦士登的 IBAN。

• 如何支持瑞士法郎或欧元以外的货币？
  你不能。按规范，QR 账单仅支持瑞士法郎和欧元。

• 如何更改翻译以使用我自己的措辞？
  你不能。翻译在 QR 帐单规范中定义，用户不得更改。请参阅本文档第 31 页。

• 如何通过 Twint 支付我的 QR 账单？
  参见#129

• 该库支持哪些 PDF 库？
  目前积极支持以下库：

  • fpdf/fpdf
  • tecnickcom/tcpdf
  • setasign/fpdi （被FpdfOutput和TcPdfOutput接受）

  HtmlOutput的输出已知用于使用 PrinceXML、Docraptor 和 dompdf/dompdf 生成 PDF（进行了一些调整，如此处所述）

• 为什么你在大多数课程中都使用final ？我想延长它们！
  该库实现了QR账单的官方规范。此实施不应进行调整，因为它可能会导致 QR 账单损坏。因此，许多课程被标记为最终课程。如果您发现需要扩展这些最终类之一，您可能会在这个库中发现一个错误。在这种情况下，如果您在此处提供错误报告甚至拉取请求，将会非常有帮助。谢谢你！

寻求帮助

您在使用该库时需要更多帮助吗？

• 搜索现有和已解决的问题，看看是否能在那里找到答案。
• 如果您仍然需要帮助，您可以自己创建一个问题来提出您的问题。

请注意，该库的维护者不会通过电子邮件提供任何支持。开源软件的美妙之处在于每个人都可以从彼此中受益。因此，问题只能公开回答。

版本控制

该库使用语义版本控制。

此外，如果二维码或支付部分的输出发生任何明显的变化，即使它可以被认为只是一个错误修复，也将始终发布次要版本。

PHP版本支持

该库支持 PHP 版本，只要它至少占当前安装的 10% 左右。

依赖支持

只要旧版本的依赖项不妨碍进一步开发或占相应依赖项当前安装的至少约 10%，则支持它们。

支持项目

• 你喜欢这个项目吗？考虑 Github 赞助。
• 您愿意贡献吗？查看未解决的问题。善待彼此。
• 传播这个词！

官方资源

该存储库包含该库所基于的官方规范：

• 瑞士实施指南 QR 法案
• 有关 QR-IID 和 QR-IBAN 的技术信息
• 风格指南 QR-bill
• 验证工具

更多官方信息请参见

• https://www.six-group.com/en/products-services/banking-services/ payment-standardization/standards/qr-bill.html

对于这个库的贡献者

如何生成新的测试数据：

1. 在TestQrBillCreatorTrait中设置$regenerateReferenceFiles = true
2. composer update --prefer-lowest
3. vendor/bin/phpunit – 忽略testQrFile中失败的测试
4. composer update
5. vendor/bin/phpunit – 不应该再有错误
6. 在TestQrBillCreatorTrait中设置$regenerateReferenceFiles = false