Request for QR Code
API URL = https://api.qrstart.eu
Method = POST
Method = POST
{
'type': 'bank',
'apikey': 'ApiKey',
'amount': 1000,
'currency': 'CZK',
'date': '20210101',
'account': '123456789/6666',
'note': 'QR Platba',
'variable': '20210001'
}
Response for QR Code
{
'success': true,
'url': 'https://api.qrstart.eu/files/abcdefghijklmn.png'
}
Request for PDF upload
API URL = https://upload.qrstart.eu
Method = POST
Method = POST
{
'apikey': 'ApiKey',
'file': '/var/www/your-site/file.pdf'
}
Response for PDF upload
{
'success': true,
'fingerprint': '315add676b4eeb3f606cfe8903448ed8c2ac468d'
}
Input parameters
-
type
- type of code-
possible values are bank, ean13, code128, text (default bank)
-
type bank:
amount
- the amount (int or float)- required
currency
- CZK or EUR- required for CZ/SK bank
- for SEPA bank, the currency is automatically EUR
bank
- CZ or SK or SEPA- CZ for czech QR code, SK for slovak QR code (it means CZ for czech bank app, SK for slovak bank app)
- SEPA means EPC SEPA format
- if empty, CZ for CZK currency and SK for EUR currency will be used
account
- whole account number include bank code (123-456789123/4567)- for CZK currency
iban
- IBAN- required for EUR currency (or for CZK, if you don't want to fill account)
swift
- SWIFT code (BIC)variable
- variable symbolconstant
- constant symbolspecific
- specific symbolnote
- note for the payerdate
- due date (format YYYYMMDD)size
- size of generated png image in pixels (min. 50, max. 600, default 150)- for pdf the size is in mm
margin
- image margin in pixels (default 2)tag
- internal note (visible in the dashboard, max. 50 chars)reference
- payer reference- for SK bank EUR currency (variable and constant and specific must be empty)
- for SEPA bank
beneficiary
- beneficiary name- for SEPA bank only
remittance
- remittance text- for SEPA bank only (reference must be empty)
instant
0-1 (int) (default 0)- use 1 for instant payment
- for CZ bank only
-
type ean13:
code
- EAN-13 code- required
size
- 1-5 (int) (default 2)- for pdf the size is in mm
tag
- internal note (visible in the dashboard, max. 50 chars)
-
type code128:
code
- some text- required
size
- 1-5 (int) (default 2)- for pdf the size is in mm
tag
- internal note (visible in the dashboard, max. 50 chars)
-
type text:
code
- some text- required
size
- size of generated png image in pixels (min. 50, max. 600, default 150)- for pdf the size is in mm
margin
- image margin in pixels (default 2)tag
- internal note (visible in the dashboard, max. 50 chars)
-
-
if you want put QR Code to you pdf file (max. size 1 MB), add following parameters
file
- location of pdf file on servertop
- position from top in mmbottom
- position from bottom in mm- in one request use top or bottom
left
- position from left in mmright
- position from right in mm- in one request use left or right
page
- the page on which the image is saved (default 1)- for last page use value -1
-
by default the QR code image is generated as PNG, but you can also generate it as JPG/WEBP
output
- jpg or webp- jpg value creates an image in JPG format
- webp value creates an image in WEBP format
You can also generate a QR code with a GET request
Request for QR Code
API URL = https://api.qrstart.eu
Method = GET
Method = GET
https://api.qrstart.eu/?type=bank&apikey=XXXXXX&amount=10¤cy=EUR&iban=SK0123456789
The result, if the input is valid, is the URL of the qr code image. Otherwise, error text and http code 400.If you put &image=1 as another parameter in the URL, the image itself will be sent instead of the URL of the image.
image
- output as image with header Content-Type image/png (or image/jpeg or image/webp)- the only possible value is 1