Jak funguje QR platba: formát SPD krok za krokem

QR kód na faktuře dnes klienti berou jako samozřejmost: naskenují ho v bankovní aplikaci, údaje se předvyplní a platba odejde bez přepisování čísla účtu a variabilního symbolu. Málokdo ale ví, co v tom čtverečku vlastně je. Odpověď je překvapivě jednoduchá: obyčejný textový řetězec ve formátu SPD (Short Payment Descriptor), standardu České bankovní asociace. Když pochopíte jeho strukturu, poznáte i to, proč některé QR kódy banka nenačte a jak si vygenerovat vlastní, který funguje vždy.

Co v článku najdete

• QR platba jednoduše: co se stane po naskenování
• Co je SPD a kdo za ním stojí
• Jak vypadá payload uvnitř QR kódu
• Kompletní přehled polí SPD a limity délek
• Znaková sada: žádná diakritika
• Nejčastější chyby a jak je odhalit
• Jak QR platbu vygenerovat a dát na fakturu
• QR platba vs. QR faktura vs. EPC QR
• Bezpečnost: dá se QR platba zneužít?
• QR platba u přijatých dokladů
• Časté otázky
• Zdroje a reference

QR platba jednoduše: co se stane po naskenování

Nejdřív úplně lidsky: QR platba je čtvereček na faktuře, ve kterém je "schovaný" celý platební příkaz. Klient ho vyfotí mobilním bankovnictvím, aplikace z něj přečte číslo účtu, částku i variabilní symbol, sama je vyplní do formuláře a člověk platbu jen zkontroluje a potvrdí. Nic nepřepisuje, takže nic nesplete.

Technicky se po naskenování stane toto: čtečka v bankovní aplikaci dekóduje QR kód na textový řetězec, podle hlavičky SPD* pozná, že jde o platební data, rozparsuje jednotlivé dvojice klíč:hodnota a přemapuje je na pole platebního příkazu. Celé to trvá zlomek sekundy a funguje offline, QR kód se nikam nepřipojuje, jen nese data.

Pro vystavovatele faktury z toho plyne praktický přínos: méně překlepů ve variabilním symbolu znamená méně plateb, které nejde spárovat s fakturou, a rychlejší úhrady. Přesně proto QR platbu dnes najdete na fakturách, složenkách i výzvách k platbě od pojišťoven a úřadů.

Co je SPD a kdo za ním stojí

SPD (Short Payment Descriptor, někdy uváděný jako SPAYD) je otevřený standard pro zápis platebních údajů do QR kódu. Vznikl v roce 2012 a v listopadu 2012 ho Česká bankovní asociace přijala jako oficiální standard pro QR platby v České republice. Je veřejně dostupný, bez licencí a poplatků, takže ho může použít kdokoli, od velké banky po živnostníka, který si tiskne faktury doma.

Podporují ho mobilní aplikace všech velkých českých bank: Česká spořitelna, ČSOB, Komerční banka, Raiffeisenbank, MONETA Money Bank, Fio banka, Air Bank nebo mBank. V praxi to znamená, že QR platbu na vaší faktuře načte prakticky každý klient s českým bankovnictvím v mobilu.

Princip je prostý: platební údaje se zapíší do jednoho textového řetězce podle pevných pravidel a ten se zakóduje do QR kódu. Bankovní aplikace kód přečte, řetězec rozparsuje a předvyplní platební příkaz. Žádná databáze, žádný server, všechna data jsou přímo v kódu.

Jak vypadá payload uvnitř QR kódu

Představte si to jako nákupní seznam s pevnými pravidly: na prvním řádku je jméno seznamu, pak položky oddělené hvězdičkou. Typický řetězec pro fakturu na 12 100 Kč vypadá takto:

SPD*1.0*ACC:CZ2806000000000168751329*AM:12100.00*CC:CZK*X-VS:2026042*MSG:FAKTURA 2026042*RN:JAN NOVAK

Rozeberme ho po částech:

• SPD* je pevná hlavička, podle které aplikace pozná, že jde o QR platbu
• 1.0* je verze protokolu (aktuální a jediná používaná verze je 1.0)
• dále následují dvojice KLÍČ:HODNOTA oddělené hvězdičkou, na pořadí polí nezáleží

Podle specifikace formátu je z celého řetězce povinné jediné pole: ACC, tedy účet příjemce. Všechno ostatní je volitelné. QR kód, který obsahuje jen účet, je tedy technicky validní, klient si částku i symbol doplní sám. Na faktuře ale chcete vyplnit minimálně účet, částku, měnu a variabilní symbol, jinak QR platba ztrácí smysl.

Konkrétní modelový příklad: živnostník Jan Novák fakturuje klientovi 10 000 Kč bez DPH, jako plátce přičte 21 % DPH, tedy celkem 12 100 Kč (kolik přesně DPH dělá u jiných částek si spočítáte v kalkulačce DPH). Do pole AM zapíše 12100.00, do X-VS číslo faktury 2026042 a do MSG krátký popis bez diakritiky. Přesně tak vznikl řetězec výše.

Kompletní přehled polí SPD a limity délek

Nejprve jednoduše: každé pole je jedna "kolonka" platebního příkazu a každá má maximální délku. Co je delší, aplikace ořízne. Tady je kompletní přehled podle oficiální specifikace, včetně polí, která většina návodů vynechává.

Základní pole formátu SPD 1.0

Klíč	Povinné	Max. délka	Význam
ACC	ano	46 znaků	IBAN příjemce, volitelně + BIC oddělený znakem +
ALT-ACC	ne	93 znaků	Alternativní účty příjemce oddělené čárkou
AM	ne	10 znaků	Částka, tečka jako oddělovač, max. 2 desetinná místa
CC	ne	3 znaky	Měna podle ISO 4217, typicky CZK
RF	ne	16 znaků	Reference platby pro příjemce (celé číslo)
RN	ne	35 znaků	Jméno příjemce
DT	ne	8 znaků	Datum splatnosti ve tvaru YYYYMMDD
PT	ne	3 znaky	Typ platby, hodnota IP vyžádá okamžitou platbu
MSG	ne	60 znaků	Zpráva pro příjemce
NT	ne	1 znak	Notifikace: P (telefon) nebo E (e-mail)
NTA	ne	320 znaků	Telefon nebo e-mail pro notifikaci
CRC32	ne	8 znaků	Kontrolní součet celého řetězce (hexadecimálně)

K tomu existují rozšiřující pole s prefixem X-, česká specialita pro tuzemský platební styk:

Rozšířená pole pro ČR (prefix X-)

Klíč	Max. délka	Význam
X-VS	10 znaků	Variabilní symbol, obvykle číslo faktury
X-SS	10 znaků	Specifický symbol
X-KS	10 znaků	Konstantní symbol
X-ID	20 znaků	Identifikátor platby na straně plátce
X-URL	140 znaků	URL s doplňujícími informacemi k platbě
X-PER	2 znaky	Počet dní, po které se má platba opakovat (0 až 30)

Pokud pole limit překročí, aplikace podle specifikace zpracuje jen povolený počet znaků zleva a zbytek tiše ořízne. Delší text do MSG se tedy nevyplatí. A pozor na AM: tečka jako desetinný oddělovač je povinná, zápis 12100,00 s čárkou je nevalidní.

Znaková sada: žádná diakritika

Druhé nejčastější úskalí po IBANu. Aby QR kód zůstal malý a spolehlivě čitelný, používá SPD efektivní alfanumerický režim QR kódování. Základní znaková sada proto obsahuje pouze:

• číslice 0-9
• velká písmena A-Z bez diakritiky
• mezeru a znaky $ % * + - . / :

Zprávu pro příjemce i jméno příjemce proto pište bez háčků a čárek: FAKTURA 2026042 NOVAK, ne Faktura č. 2026042 Novák. Hvězdička je vyhrazený oddělovač polí, v hodnotě se musí zapsat URL kódováním jako %2A, stejně jako jiné znaky mimo sadu. V praxi je nejjednodušší se speciálním znakům vyhnout úplně. Kód s diakritikou sice některá aplikace přelouskne, jiná ale ne, a vy se o problému dozvíte až od klienta, kterému platba neprošla.

Nejčastější chyby a jak je odhalit

Když bankovní aplikace kód "nevidí" nebo hlásí chybu, příčina je skoro vždy jedna z těchto pěti:

1. Domácí číslo účtu místo IBAN v poli ACC. Nejčastější chyba vůbec. Řešení: přepočítat na IBAN.
2. Čárka místo tečky v částce. AM:12100,00 je nevalidní, správně AM:12100.00.
3. Diakritika nebo malá písmena ve zprávě. Některé aplikace kód odmítnou, jiné ho přečtou špatně.
4. Hvězdička uvnitř hodnoty. Rozbije parsování celého řetězce, protože hvězdička odděluje pole.
5. Příliš malý nebo nekvalitní tisk. QR kód menší než zhruba 2 x 2 cm nebo rozmazaný inkoustovou tiskárnou starší telefony nepřečtou.

Rychlý test před odesláním faktury: naskenujte kód vlastním mobilním bankovnictvím. Když se předvyplní správný účet, částka i variabilní symbol, je hotovo. Trvá to deset sekund a ušetří reklamaci od klienta.

Jak QR platbu vygenerovat a dát na fakturu

Nemusíte nic programovat ani instalovat. Celý postup zvládnete za pár minut:

Generátor najdete zdarma na našem webu: generátor QR platby podle standardu ČBA. Funguje bez registrace a data neopouštějí váš prohlížeč.

QR kód na faktuře reálně zrychluje úhrady: klient nemusí přepisovat 10místný variabilní symbol ani kontrolovat číslo účtu, takže odpadají překlepy a s nimi i nepárovatelné platby. Pro účetní to znamená méně dohledávání, kdo vlastně co zaplatil.

QR platba vs. QR faktura vs. EPC QR

Tři pojmy, které se pletou. Jednoduše: QR platba nese jen platební údaje, QR faktura navíc i účetní data celé faktury a EPC QR je evropský bratranec pro eurové platby.

Srovnání QR standardů pro platby a faktury

Standard	Co nese	Kde funguje	Typické použití
QR platba (SPD)	Platební údaje: účet, částka, VS, zpráva	České bankovní aplikace	Faktury, složenky, výzvy k platbě v ČR
QR faktura (ČBA)	Platební údaje + účetní data faktury (DIČ, DUZP, rozpis DPH)	České účetní systémy a banky	Automatické zaúčtování přijaté faktury
EPC QR (SEPA)	Platební údaje pro SEPA úhradu v EUR	Banky v eurozóně	Eurové faktury do zahraničí

Formát SPD umí přes pole CC:EUR nastavit i eurovou částku, to ale funguje jen tam, kde banka takovou úhradu z SPD kódu podporuje. Pro SEPA platby do zahraničí existuje samostatný evropský standard EPC QR, který čtou bankovní aplikace napříč eurozónou a má jinou strukturu než SPD. Oba formáty nejsou vzájemně zaměnitelné: český SPD kód slovenská aplikace typicky nenačte a naopak. Tématu se věnujeme v samostatném článku QR platba v eurech: formát EPC pro SEPA platby.

Bezpečnost: dá se QR platba zneužít?

Jednoduchá odpověď: samotný QR kód nebezpečný není, je to jen text. Riziko vzniká, když někdo kód podvrhne, například přelepí QR kód na vytištěné faktuře nebo složence vlastním kódem se svým účtem. Tento typ podvodu se objevil i v Česku, typicky na fakturách posílaných poštou nebo na letácích.

Obrana je jednoduchá a platí pro obě strany:

• Plátce vždy zkontroluje předvyplněné údaje před potvrzením platby, hlavně číslo účtu a částku. Bankovní aplikace nikdy neodešle platbu bez potvrzení.
• Vystavovatel posílá faktury elektronicky (PDF nelze přelepit) a uvádí platební údaje i textově vedle QR kódu, aby si je klient mohl porovnat.

Druhá dobrá zpráva: QR platba nenese žádné přihlašovací údaje ani nic, co by šlo odcizit. I kdyby kód z vaší faktury získal kdokoli cizí, dozví se jen to, co je na faktuře stejně napsané.

QR platba u přijatých dokladů

Zatím jsme řešili QR kód na vystavené faktuře. Stejná logika ale pomáhá i na druhé straně, u dokladů, které sami platíte. DokladBot ke každému přijatému dokladu automaticky připraví QR kód k zaplacení: z faktury vytáhne účet, částku i variabilní symbol, sestaví SPD payload a vy platbu jen naskenujete v bankovnictví a potvrdíte. Žádné přepisování údajů z PDF do příkazu, žádné překlepy ve variabilním symbolu. Jak to celé funguje přes WhatsApp, ukazujeme na stránce přehledu funkcí DokladBota, konkrétní tarify pak najdete v ceníku.

Závěr

QR platba není žádná magie: je to textový řetězec podle standardu ČBA z roku 2012, kde stačí dodržet tři pravidla. Účet vždy jako IBAN, text bez diakritiky a limity délek jednotlivých polí. Kdo je dodrží, má jistotu, že kód načte každá česká bankovní aplikace.

Vyzkoušejte si to hned: vygenerujte QR kód pro svou příští fakturu v bezplatném generátoru QR platby. A pokud chcete mít QR kód k zaplacení automaticky u každého přijatého dokladu, vyzkoušejte DokladBot zdarma.

Časté otázky

Musí být v QR platbě číslo účtu jako IBAN?

Ano. Pole ACC ve formátu SPD přijímá výhradně IBAN, pro české účty tvar CZ + 22 číslic, nikoli domácí formát číslo účtu/kód banky. Převod z domácího formátu je čistě matematický a zvládne ho zdarma každý převodník, dotaz do banky není potřeba.

Které banky umí QR platbu načíst?

QR platba je standard České bankovní asociace a čtou ji mobilní aplikace všech velkých českých bank: Česká spořitelna, ČSOB, Komerční banka, Raiffeisenbank, MONETA Money Bank, Fio banka, Air Bank i mBank. Klient kód naskenuje, údaje se předvyplní a platbu jen potvrdí.

Může být v QR platbě diakritika?

Ne. Základní znaková sada SPD obsahuje jen číslice 0-9, velká písmena A-Z bez diakritiky, mezeru a několik znaků jako tečku, pomlčku nebo lomítko. Zprávu i jméno příjemce pište bez háčků a čárek, jinak riskujete, že některá aplikace kód nenačte.

Kolik stojí použití QR platby na faktuře?

Nic. SPD je otevřený standard bez licenčních poplatků a QR kód si vygenerujete zdarma, například v našem online generátoru. Banka si za přijetí platby z QR kódu neúčtuje nic navíc oproti běžnému příkazu.

Je QR platba povinná na faktuře?

Ne. Žádný zákon QR kód na faktuře nevyžaduje, povinné náležitosti faktury určuje zákon o DPH (č. 235/2004 Sb., § 29) a zákon o účetnictví a QR kód mezi nimi není. Je to čistě praktický doplněk, který zrychluje úhrady.

Jak velký má být QR kód na vytištěné faktuře?

Doporučuje se minimálně 2 x 2 cm při běžném tisku. Menší nebo rozmazaný kód starší telefony nemusí přečíst. U PDF faktur na velikosti tolik nezáleží, klient si fakturu na displeji přiblíží.

Funguje formát SPD i pro platby v eurech do zahraničí?

Formát SPD umí přes pole CC nastavit i měnu EUR, to ale řeší jen platby, které banka z SPD kódu podporuje. Pro SEPA platby do zahraničí slouží samostatný evropský standard EPC QR, který čtou banky v eurozóně. Oba formáty nejsou zaměnitelné.

Zdroje a reference

• Specifikace formátu SPD 1.0, oficiální web QR Platba (Česká bankovní asociace)
• QR Platba, standard České bankovní asociace, informace pro veřejnost
• Zákon č. 235/2004 Sb., o dani z přidané hodnoty, § 29 (náležitosti daňového dokladu), zakonyprolidi.cz/cs/2004-235