QRGENERATOR.SK / LEGACY API
QR platby.
Jednoducho na faktúre.
Bezplatné API na tvorbu slovenských platobných QR kódov PAY by square. Dokumentácia a príklady pre vaše existujúce integrácie.
Pôvodné API adresy zostávajú funkčné.
ĎALŠIA KAPITOLA
Projekt pokračuje na QRFactory.dev
Táto verzia QRGenerator.sk je zastaraná (legacy). Pre nové integrácie použite QRFactory.dev so samostatnými API pre slovenský PAY by square a českú QR Platbu.
Ukážka slovenského API ↗
Ukážka českého API ↗
Nové API je dostupné na api.qrfactory.dev. Dokumentáciu nájdete na QRFactory.dev. Ukážky obsahujú testovacie údaje; platbu neodosielajte.
VÝVOJ PROJEKTU
Čo sa zmenilo
Od prvých QR platieb v roku 2020 po QRFactory.dev.
Nový vzhľad, známe API
Farby podľa Zenvio, prehľadnejšia dokumentácia a história zmien. QRFactory.dev prináša rozšírený návod aj galériu QR variantov. Existujúce integračné adresy sa nemenia.
Spustenie QRFactory.dev
Nová generácia API prináša samostatné služby pre slovenské a české platobné QR kódy. QRGenerator.sk zostáva dostupný ako legacy služba.
Príprava API pre AWS Lambda
Úprava zostavenia API pre prevádzku na AWS Lambda. API dnes beží v regióne Frankfurt.
Aktualizácia webu
Aktualizované informácie o Zenvio a konfigurácia webového hostingu.
Obnova webu a ukážok
Aktualizácia technického základu webu, úprava navigácie a oprava ukážok na testovanie QR kódov.
Spracovanie textov s diakritikou
Pribudla možnosť odstrániť diakritiku z poznámky k platbe, mena a adresy príjemcu. Túto úpravu možno ovládať parametrom normalize.
Meno príjemcu a čitateľnejšie faktúry
QR platba môže obsahovať meno a adresu príjemcu. Dokumentáciu doplnili porovnania veľkostí QR obrázkov a odporúčania na ich zobrazenie na webe a v PDF.
Presnejšie vykresľovanie QR kódov
Vylepšený výpočet veľkosti, okrajov a umiestnenia QR kódu v rámčeku podľa množstva platobných údajov. Pribudli aj testovacie ukážky rôznych veľkostí a dlhších poznámok.
Priehľadné pozadie a okraje
Pribudla voľba medzi priehľadným a bielym pozadím obrázka a možnosť pridať ochranný okraj okolo QR kódu.
Dokumentácia pre prvé integrácie
Web doplnili príklady vloženia QR obrázka do stránky, výstupu vo formáte Base64 a platobného reťazca na ďalšie spracovanie.
QR kódy s rámčekom aj bez neho
Prvé možnosti prispôsobenia vzhľadu: rámček PAY by square, logo pod kódom alebo čistý QR kód. Doplnili ich rôzne veľkosti a obrazové formáty.
Začiatok QRGenerator.sk
Vznikol prvý funkčný generátor slovenských platobných QR kódov PAY by square z IBAN-u, sumy a ďalších platobných údajov. O dva dni neskôr sa začal vývoj webu.
Dokumentácia
Pay By Square
QRGenerator.sk podporuje tvorbu QR kódov v proprietárnom formáte Pay By Square, podľa dostupnej dokumentácie Slovenskej Bankovej Asociácie.
QR je k dispozícií v týchto variantách:
- png/jpeg na priame použitie v
<img>tagu - png/jpeg vo formáte base64 stringu
- QR string na ďalšie použitie
QR ako png/jpeg
Obrázok generujú dva endpointy:
https://api.qrgenerator.sk/by-square/pay/qr.png
a
https://api.qrgenerator.sk/by-square/pay/qr.jpg
Endpoint vygeneruje validný QR kód iba v prípade, ak je zavolaný so správnymi parametrami uverenými v URL query. Zoznam dostupných parametrov:
Parametre
iban- povinné - číslo účtu prijímateľa platby vo formáte IBANamount- povinné - suma transakcie, napr. 1200.99currency- voliteľné - mena transakcie. default: EURdue_date- voliteľné - dátum splatnosti transakcie, formát yyyy-MM-dd, napr. 2020-12-31vs- voliteľné - variabilný symbolss- voliteľné - špecifický symbolcs- voliteľné - konštantný symbolpayment_note- voliteľné - poznámka k platbebeneficiary_name- voliteľné - meno príjemcubeneficiary_address1- voliteľné - adresa príjemcu 1beneficiary_address2- voliteľné - adresa príjemcu 2-
mode- voliteľné - možnosti:- full - branding rám okolo QR kódu
- bottom - branding logo pod QR kódom
- none - bez brandingu
-
size- voliteľné - veľkost výsledného obrázka, možnosti:- 128 - veľkost 128px, default
- 256 - veľkost 256px
- 512 - veľkost 512px
-
transparent- voliteľné - priehľadnoť výsledného QR kódu. Možnosti- true - priehľadný
- false - biele pozadie
Príklad
HTML
<img
src="https://api.QRGenerator.sk/by-square/pay/qr.png?
iban=SK8975000000000012345671&
amount=10&
currency=EUR&
vs=20200001&
payment_note=poznamka&
due_date=2026-09-18&
size=128&
transparent=false"
alt="QR kod"
/>
Náhľad
Veľkosť obrázka
Veľkosť vygenerovaného obrázka s QR kódom určuje parameter size. Z praktických skúsenosti doporučujem vygenerovať vačší QR kód a následne nechať prehliadač alebo PDF renderer aby urobil primeraný downscalling. Výsledná čitateľnost QR kódu je lepšia, ako pri opačnom postupe, ked vygenerujeme menší obrázok a urobíme upscalling. Napr. ak požadujem obrázok o zhruba velkosťi 400px, requestujem radšej veľkost 512 a robím downscalling, ako 256 s upscallingom.
512px
Downscalling
512px obrázok nastavený na 25% šírku
128px
Downscalling
128px obrázok nastavený na 25% šírku
Upscalling
512px obrázok nastavený na 100% šírku
Upscalling
128px obrázok nastavený na 100% šírku
QR ako base64
Base64 string je dostupný na endpointehttps://api.qrgenerator.sk/by-square/pay/base64
Parametre
Kombináciu parametrov je nutné posielať v URL.- parametre pre PNG/JPG variant +
format- povinné - výstupný formát obrázka - png / jpeg / bmpunit_size- voliteľné - počet pixelov na segment QR kódu
Príklad
GET Request
https://api.QRGenerator.sk/by-square/pay/base64?format=png&iban=SK8975000000000012345671&amount=10¤cy=EUR&vs=20200001&payment_note=poznamka&due_date=2026-09-18&unit_size=10
Response
{
"mime" : "image/png",
"data" : "iVBORw0KGgoAAAANSUhEUgAAAIAAAACWCAYAAAAWsYBNAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAA7XSURB................."
}
QR String
Vstupný text resp. string na vygenerovanie QR kódu je dostupný na endpointehttps://api.qrgenerator.sk/by-square/pay/string
Parametre
Kombináciu parametrov je nutné posielať v URL.iban- povinné - číslo účtu prijímateľa platby vo formáte IBANamount- povinné - suma transakcie, napr. 1200.99currency- voliteľné - mena transakcie. default: EURdue_date- voliteľné - dátum splatnosti transakcie, formát yyyy-MM-dd, napr. 2020-12-31vs- voliteľné - variabilný symbolss- voliteľné - špecifický symbolcs- voliteľné - konštantný symbolpayment_note- voliteľné - poznámka k platbebeneficiary_name- voliteľné - meno príjemcubeneficiary_address1- voliteľné - adresa príjemcu 1beneficiary_address2- voliteľné - adresa príjemcu 2
Príklad
GET Request
https://api.QRGenerator.sk/by-square/pay/string?iban=SK8975000000000012345671&amount=10¤cy=EUR&vs=20200001&payment_note=poznamka&due_date=2026-09-18
Response
{
"data" : "0006E000CODK3AOG9C62MCETHLG0V9OP3H32ERPJJD47BBTH9G4SVC9VOTTG6GQS8C18FTDIN5EAMJR1MCAU0PDGQQIA13VK2R00C7KO79KKM9P80"
}
INFRAŠTRUKTÚRA A SÚKROMIE
API beží na AWS.
Vo Frankfurte.
Amazon Web Services · eu-central-1
Spracovanie platobných údajov
API poskytnuté údaje neukladá, nezdieľa ani neposiela ďalej. Prijme požiadavku, spracuje ju a vráti QR kód.
Cookies a analytika
Webstránka používa cookies a Google Analytics.
Bezplatne a férovo
Služba je poskytovaná bezplatne. Podmienkou používania je dodržiavanie FUP (Fair Use Policy): používanie nesmie obmedzovať ani obťažovať ostatných používateľov.