Ak vám zákazník píše, že QR kód na faktúre mu banka nenačíta, v drvivej väčšine prípadov nejde o chybu jeho telefónu ani o „rozmazanú tlač”. Príčina býva v tom, ako bol kód vyrobený — a zákazník s tým nevie urobiť nič. Dobrou správou je, že sa to dá overiť za minútu a väčšinou má riešenie v rukách ten, kto faktúru vystavuje.
Tento návod vychádza z problému, na ktorý sme narazili pri stavbe vlastného generátora platobných QR kódov. Prejdeme si, čím sa slovenský platobný QR kód líši od bežného QR, aké sú štyri najčastejšie príčiny odmietnutia, ako rýchlo rozlíšiť chybu kódu od chyby aplikácie — a na konci je technická časť pre tých, ktorí QR kódy sami generujú.
Pay by Square nie je obyčajný QR kód
Toto je najčastejšie nedorozumenie. Keď si vygenerujete QR kód v ľubovoľnom online generátore a vložíte doňho text „IBAN SK12 1200 …, suma 120 €”, žiadna banková aplikácia z toho platbu nepredvyplní. Prečíta síce text, ale nevie, čo je v ňom číslo účtu a čo suma.
Slovenské banky používajú štandard Pay by Square, ktorý spravuje Slovenská banková asociácia. Ten presne definuje, ako sa prevodný príkaz zabalí do QR kódu:
- údaje (IBAN, suma, mena, variabilný a konštantný symbol, správa, splatnosť) sa zoradia do presne určeného poradia,
- doplní sa kontrolný súčet CRC32,
- všetko sa skomprimuje algoritmom LZMA,
- pridá sa krátka hlavička, ktorá hovorí, o aký typ a verziu dokumentu ide,
- výsledok sa zakóduje do textu, ktorý ide do QR kódu.
Aplikácia banky postupuje presne opačne. Ak jej čokoľvek v tomto reťazci nesedí, platbu nepredvyplní a zobrazí chybu — typicky „Nepodporovaný typ QR kódu” alebo „Údaje sa nepodarilo načítať”. Práve preto sa platobný QR kód nedá vyrobiť v bežnom generátore obrázkov a preto sa chyba nedá „opraviť lepším telefónom”.
Štyri najčastejšie príčiny, prečo banka QR odmietne
1. Nesprávna verzia v hlavičke kódu
Najzákernejšia príčina, lebo kód vyzerá úplne normálne a niektoré aplikácie ho dokonca prečítajú. V hlavičke Pay by Square je uložené číslo verzie a ak je vyššie, než akú verziu pozná aplikácia banky, špecifikácia jej priamo prikazuje ukončiť čítanie chybou. Nie je to teda chyba banky — správa sa presne tak, ako má.
Zákazník s tým nevie urobiť nič. Opraviť to musí ten, kto kód generuje. Podrobnosti sú v technickej časti nižšie.
2. Diakritika v údajoch
Banky pracujú s platobnými údajmi bez diakritiky. Ak sa do kódu dostane „Faktúra 2026001” alebo meno príjemcu s mäkčeňmi, časť aplikácií si s tým poradí a časť nie — vznikne presne ten nepríjemný stav, keď kód „niekomu funguje a niekomu nie”.
Správne vyrobený kód diakritiku odstráni automaticky: z „faktúry” sa v kóde stane „faktura”. Na vytlačenej faktúre diakritika samozrejme zostáva, mení sa len obsah QR kódu.
3. Chybný IBAN
Preklep v čísle účtu je banálna, ale prekvapivo častá príčina. IBAN má v sebe kontrolné číslice a aplikácia si ho overí — ak nesedí kontrolný súčet, platbu odmietne predvyplniť. Rovnako pochodí kód, do ktorého sa IBAN dostal s medzerami alebo s malými písmenami tam, kde majú byť veľké.
Toto si viete overiť sami: zadajte IBAN do nášho generátora a ak je v ňom preklep, upozorní vás ešte pred vytvorením kódu.
4. Príliš malý alebo poškodený QR pri tlači
Jediná z príčin, ktorú naozaj spôsobí tlač. Pay by Square nesie pomerne veľa údajov, takže mriežka kódu býva hustá. Ak ho na faktúre zmenšíte na štvorec veľkosti nechta, telefón ho jednoducho neprečíta.
Čo pomáha:
- veľkosť aspoň 2 × 2 cm, ideálne okolo 3 × 3 cm,
- biele okraje okolo kódu — nelepte ho tesne k textu ani k rámčeku tabuľky,
- dostatočný kontrast, žiadne podfarbenie ani vodoznak pod kódom,
- pri posielaní faktúry e-mailom PDF, nie preposlaná fotka faktúry.
Ako zistiť, či je chyba v kóde alebo v aplikácii
Toto je najrýchlejší spôsob, ako si ušetriť dohadovanie so zákazníkom. Trvá minútu:
- Otvorte si v telefóne ľubovoľný iný platobný QR kód — napríklad z faktúry od dodávateľa, z poštovej poukážky alebo z faktúry za telefón.
- Naskenujte ho v tej istej bankovej aplikácii, v ktorej zlyhal váš kód.
- Vyhodnoťte:
- Cudzí kód sa načíta, váš nie → problém je vo vašom kóde. Čítajte ďalej.
- Nenačíta sa ani jeden → problém je v aplikácii alebo v telefóne (zastaraná verzia aplikácie, odopreté právo na fotoaparát, poškriabaná šošovka).
- Ak máte podozrenie na tlač, skúste ten istý kód naskenovať priamo z obrazovky namiesto z papiera. Ak z obrazovky funguje a z papiera nie, príčinou je veľkosť alebo kvalita tlače.
Užitočný je aj druhý telefón s inou bankou. Ak kód odmietnu dve rôzne banky, chyba je takmer isto v kóde — dve nezávislé aplikácie sa nemýlia rovnako.
Čo viete opraviť sami a čo musí riešiť tvorca softvéru
| Príčina | Kto to vie opraviť |
|---|---|
| Malý alebo nekvalitne vytlačený kód | Vy — zväčšite kód, nechajte okolo neho okraj |
| Preklep v IBAN-e | Vy — opravte údaje a vygenerujte kód nanovo |
| Diakritika v údajoch | Tvorca softvéru (správny generátor ju odstráni sám) |
| Nesprávna verzia v hlavičke | Tvorca softvéru — používateľ to neovplyvní |
Ak používate fakturačný program a QR kódy z neho banky neprijímajú, nemá zmysel skúšať iné nastavenia — napíšte podporu programu a priložte snímku chybovej hlášky z bankovej aplikácie vrátane názvu banky. Je to chyba na ich strane a bez opravy v programe ju neobídete.
Kým sa to vyrieši, faktúra nie je stratená: uveďte na nej platobné údaje aj textom (IBAN, suma, variabilný symbol, splatnosť). Zákazník ich prepíše ručne a faktúru uhradí.
Pre vývojárov: verzia schémy nie je verzia v hlavičke
Táto časť je pre tých, ktorí Pay by Square kódy sami generujú. Je to presne tá pasca, na ktorú sme narazili pri stavbe vlastného generátora, a stojí za ňou jediné slovo — „verzia”, ktoré v špecifikácii znamená dve rôzne veci.
Technická špecifikácia PAY by square (Zdroj: Slovenská banková asociácia) rozlišuje:
- verziu schémy / dokumentu — teda 1.1.0, číslo, ktoré je aj v názve súboru špecifikácie. Táto verzia hovorí, aké polia dátový model obsahuje (v 1.1.0 pribudli polia pre meno a adresu príjemcu);
- verziu typu, ktorá sa zapisuje do hlavičky QR kódu — štvorbitové číslo, ktoré je pre PAY by square rovné 0. Špecifikácia to uvádza vo viacerých tabuľkách aj vetou, že aktuálny typ PAY by square je vo verzii 0.
Tieto dve čísla spolu nesúvisia. Do hlavičky patrí 0, aj keď pracujete so schémou 1.1.0.
Prečo na tom záleží: kapitola o dekódovaní hovorí, že ak je verzia v hlavičke vyššia než verzia dekodéra, čítanie sa musí skončiť chybou „unknown document error”. Banková aplikácia postavená na schéme 1.1.0 hlási verziu 0 — a kód s hlavičkou 1 alebo 2 preto odmietne. Presne toto je príčina č. 1 z prehľadu vyššie.
Pasca je v tom, že niektoré knižnice obe čísla zamieňajú a ponúkajú voľbu „verzia 1.1.0”, ktorá do hlavičky zapíše 1. Užitočné zistenie pri ladení: samotné telo kódu sa pritom nemusí vôbec meniť — pri našom generátore boli bajty údajov pre všetky tri verzie identické a líšila sa jedine hlavička. Ak teda váš kód banka odmieta, oplatí sa najskôr pozrieť na prvé dva bajty, nie prerábať celú serializáciu.
Druhá vec, ktorú treba ustrážiť: keď knižnici odovzdávate nastavenia, overte si, či ich dopĺňa k predvoleným hodnotám, alebo ich celé nahrádza. Ak nahrádza, ľahko sa stane, že zmenou jednej voľby ticho vypnete odstraňovanie diakritiky — a vyrobíte si príčinu č. 2 z tohto článku bez toho, aby ste o tom vedeli.
Na záver praktická poznámka k testovaniu: vlastný dekodér nie je dôkaz. Overí len to, že kód viete prečítať rovnakým postupom, akým ste ho vyrobili — vrátane prípadnej chyby. Jediný spoľahlivý test je naskenovať kód v reálnej bankovej aplikácii, ideálne v dvoch rôznych bankách.
Časté otázky
Dá sa platobný QR kód vyrobiť v bežnom online generátore QR kódov?
Nie. Bežný generátor zakóduje len text a banková aplikácia z neho platbu nepredvyplní, lebo nevie, čo je číslo účtu a čo suma. Slovenské banky čítajú štandard Pay by Square, v ktorom sa údaje zoradia v presnom poradí, doplní sa kontrolný súčet, skomprimujú sa a pridá sa hlavička s typom a verziou dokumentu.
Ako rýchlo zistím, či je chyba v mojom kóde alebo v aplikácii zákazníka?
V tej istej bankovej aplikácii naskenujte iný platobný QR kód, napríklad z faktúry od dodávateľa. Ak sa cudzí kód načíta a váš nie, problém je vo vašom kóde. Ak sa nenačíta ani jeden, chyba je v aplikácii alebo v telefóne. Ak váš kód odmietnu dve rôzne banky, chyba je takmer isto v kóde.
Aký veľký má byť QR kód na vytlačenej faktúre?
Aspoň 2 × 2 cm, ideálne okolo 3 × 3 cm. Okolo kódu nechajte biely okraj, nepodfarbujte ho a pri posielaní e-mailom pošlite PDF, nie fotku vytlačenej faktúry.
Čo robiť, kým výrobca fakturačného programu chybu neopraví?
Uveďte na faktúre platobné údaje aj textom – IBAN, sumu, variabilný symbol a splatnosť –, aby ich zákazník mohol prepísať ručne. Podpore programu pošlite snímku chybovej hlášky z bankovej aplikácie aj s názvom banky.
Zhrnutie
Keď banka nenačíta QR kód na faktúre, postupujte takto:
- Naskenujte kontrolne cudzí platobný QR kód v tej istej aplikácii.
- Ak cudzí funguje a váš nie, skontrolujte veľkosť kódu na tlači a IBAN.
- Ak je oboje v poriadku, ide o chybu generátora — ohláste ju tvorcovi softvéru.
- Dovtedy nechajte na faktúre platobné údaje aj textom, aby sa dala uhradiť ručne.
Ak potrebujete platobný QR kód hneď a bez registrácie, vygenerujte si ho u nás — kontrolujeme IBAN ešte pred vytvorením kódu, diakritiku odstraňujeme automaticky a hlavičku píšeme presne podľa špecifikácie. Otvoriť Pay by Square generátor
Údaje platné k 21. 9. 2026, pravidelne aktualizujeme. Sumy a sadzby v článku vychádzajú z oficiálnych zdrojov (finančná správa, Sociálna poisťovňa, zbierka zákonov) a majú informatívny charakter – pred rozhodnutím ich overte s účtovníkom.
