Generate QR code through our API

Request for QR Code

API URL = https://api.qrstart.eu
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


{
	'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 symbol
  - constant - constant symbol
  - specific - specific symbol
  - note - note for the payer
  - date - 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 2 MB), add following parameters
- file - location of pdf file on server
- top - position from top in mm
- bottom - position from bottom in mm
  - in one request use top or bottom
- left - position from left in mm
- right - 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

github.com

You can also generate a QR code with a GET request

Request for QR Code

API URL = https://api.qrstart.eu
Method = GET


https://api.qrstart.eu/?type=bank&apikey=XXXXXX&amount=10&currency=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