Download the PHP package hlavtox/qr-payment-string-generator without Composer

On this page you can find all versions of the php package hlavtox/qr-payment-string-generator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of hlavtox/qr-payment-string-generator

Informations about the package qr-payment-string-generator

QR Payment String Generator

QR Payment String Generator is a pure-PHP library for generating the payment strings stored inside payment QR codes. It supports three formats:

The package creates only the payment payload, not a QR image. Pass the generated string to any QR code renderer that fits your application. There are many good libraries and services available for that purpose.

The project was created because the available PHP implementations either required some external libraries to be installed in the system, required commonly blocked functions like proc_open or did not produce a scannable PAY by square code. This is dependency-free and usable anywhere.

Compatibility

Required fields and supported data

Format Required fields Practical minimum Supported setters
Slovak PAY by square IBAN, beneficiary name IBAN, amount, beneficiary name, variable symbol, payment note setBic, setCurrency, setDueDate, setVariableSymbol, setConstantSymbol, setSpecificSymbol, setOriginatorsReferenceInformation, setPaymentNote, setInvoiceId, setBeneficiaryAddressLine1, setBeneficiaryAddressLine2
Czech QR Platba IBAN IBAN, amount, variable symbol setAmount, setBeneficiaryName, setCurrency, setDueDate, setVariableSymbol, setConstantSymbol, setSpecificSymbol, setPaymentNote, setPaymentType
EPC / SEPA QR IBAN, beneficiary name IBAN, amount, beneficiary name, payment reference or payment note setAmount, setBic, setPaymentNote, setOriginatorsReferenceInformation, setPurpose, setInformation

All formats expose the same fluent API. You may call every setter on any generator; values not supported by the selected format are safely ignored.

Complete setter support matrix

Setter Example data PAY by square Czech QR Platba EPC / SEPA
setIban() 'SK8075000000004022466192' Required Required Required
setAmount() '125.50' Used if set Used if set Used if set
setBeneficiaryName() 'Example company s.r.o.' Required Used if set Required
setBic() 'CEKOSKBX' Used if set Ignored Used if set
setCurrency() 'EUR' or 'CZK' Used if set Used if set Ignored; EPC is always EUR
setDueDate() '2026-08-15' Used if set Used if set Ignored
setVariableSymbol() '001234' Used if set Used if set Ignored
setConstantSymbol() '0558' Used if set Used if set Ignored
setSpecificSymbol() '1234567890' Used if set Used if set Ignored
setOriginatorsReferenceInformation() '202600123' Used if set Ignored Ignored
setStructuredReference() 'RF18539007547034' Ignored Ignored Used if set; payment note is ignored
setPaymentNote() 'Invoice 202600123' Used if set Used if set Used as unstructured remittance information
setInvoiceId() '202600123' Used if set Ignored Ignored
setBeneficiaryAddressLine1() / setBeneficiaryAddressLine2() 'Main Street 1' Used if set Ignored Ignored
setPaymentType() 'IP' Ignored Used if set Ignored
setPurpose() 'GDDS' Ignored Ignored Used if set
setInformation() 'Thank you' Ignored Ignored Used if set

[!NOTE] For EPC, setStructuredReference() is a structured creditor reference (a structured payment reference for the recipient): a standardized machine-readable reference beginning with RF, for example RF18539007547034. setPaymentNote() is unstructured remittance information (a free-text payment reference for the recipient), such as Invoice 202600123. When both are set, the structured reference takes precedence and the payment note is ignored. setInformation() is beneficiary-to-originator information (a message from the recipient to the payer).

How to pass data

Pass the values in their business form. The generators normalize IBAN and BIC whitespace and letter case, validate format-specific limits, and throw InvalidArgumentException when a value is invalid.

Why is the amount a string?

Payment QR formats require an exact decimal representation with a period as the decimal separator. PHP floats cannot safely represent many decimal values: for example, 0.1 + 0.2 can internally become 0.30000000000000004. Pass an exact string such as '125.50' instead.

If your application stores money in minor units, for example 12550 cents, convert it to an exact decimal string at the application boundary before calling setAmount(). Do not pass a value formatted with a comma, currency symbol, or thousands separator.

Formatting summary

Setter Type Accepted format
setIban() string IBAN; spaces are accepted and removed.
setBic() string or null BIC / SWIFT; spaces are accepted and removed.
setAmount() string or null Decimal number with .; never a float.
setBeneficiaryName() / setPaymentNote() string Plain UTF-8 text; do not URL-encode it yourself.
setVariableSymbol() / setConstantSymbol() / setSpecificSymbol() string or null Digits only; use strings to preserve leading zeroes.
setDueDate() string, DateTimeInterface, or null YYYY-MM-DD when passing a string.

Install

Slovak PAY by square

Czech QR Platba

EPC / SEPA QR

Common e-commerce usage

All versions of qr-payment-string-generator with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
ext-mbstring Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package hlavtox/qr-payment-string-generator contains the following files

Loading the files please wait ...