SPAYD (Short PAYment Descriptor) je textový zápis platebních údajů, který se v Česku schovává uvnitř QR plateb. Popisuje ho standard České bankovní asociace „Formát pro sdílení platebních údajů v CZK – QR kódy". Tenhle text ho vysvětluje tak, aby se v něm vyznal i někdo, kdo nepíše programy – protože znalost formátu se hodí, kdykoli potřebujete zkontrolovat, co vlastně ve vašem kódu je.
Jak řetězec vypadá
SPD*1.0*ACC:CZ6508000000192000145399*AM:1250.00*CC:CZK*X-VS:20260042*MSG:Faktura 2026042Skládá se ze tří částí:
SPD– pevná hlavička, podle které aplikace pozná, že jde o platební údaje.1.0– verze formátu.- Jednotlivé údaje ve tvaru
KLÍČ:hodnota.
Všechno je oddělené hvězdičkou. Z toho plyne pravidlo, na které se snadno zapomene: hvězdička se nesmí objevit uvnitř žádné hodnoty, jinak by se řetězec rozpadl na nesprávné části.
Jediný povinný údaj
Povinné je pouze ACC – číslo účtu příjemce v podobě IBAN. Všechno ostatní je volitelné. Tohle překvapuje: kód bez částky, bez symbolu a bez jména je podle standardu naprosto v pořádku. Jen z něj plátce nic nevyčte a musí si údaje doplnit sám.
Údaje, které se používají nejčastěji
| Klíč | Co znamená | Omezení |
|---|---|---|
ACC | Účet příjemce (IBAN, volitelně s BIC) | povinné |
AM | Částka | nejvýše 10 znaků, max. 2 desetinná místa, tečka jako oddělovač |
CC | Měna podle ISO 4217 | právě 3 znaky, pro tuzemské platby CZK |
RN | Jméno příjemce | nejvýše 35 znaků |
MSG | Zpráva pro příjemce | nejvýše 60 znaků |
DT | Datum splatnosti | právě 8 znaků ve tvaru RRRRMMDD |
X-VS | Variabilní symbol | nejvýše 10 číslic |
X-SS | Specifický symbol | nejvýše 10 číslic |
X-KS | Konstantní symbol | nejvýše 10 číslic |
Klíče začínající na X- jsou české rozšíření. Původní formát je navržený mezinárodně a variabilní symbol nezná – proto ta předpona.
Další údaje, které formát umí
Ve standardu najdete i pole, která potkáte málokdy, ale je dobré o nich vědět:
ALT-ACC– náhradní účty, kdyby plátce nemohl poslat na ten hlavní.RF– identifikátor platby u příjemce (nejvýše 16 znaků, jen číslice).PT– typ platby; hodnotaIPoznačuje okamžitou platbu.NTaNTA– žádost o notifikaci e-mailem nebo SMS a kontakt na ni.X-PER– počet dnů, po které se má platba opakovaně zkoušet.X-ID,X-URL– identifikátor u příkazce a doplňkový odkaz.CRC32– kontrolní součet celého řetězce.
Náš generátor jich záměrně nabízí jen část. Pole, kterým bankovní aplikace nerozumí konzistentně, dělají víc škody než užitku – uživatel si myslí, že něco nastavil, a ono se to nikde neprojeví.
Povolené znaky a diakritika
Standard počítá s omezenou znakovou sadou: číslice, velká písmena A–Z, mezera a několik symbolů ($ % * + - . / :). Česká písmena s háčky a čárkami tam nejsou.
V praxi to neznamená, že diakritiku do kódu nelze zapsat – QR kód unese jakýkoli text. Znamená to, že se nemůžete spolehnout, jak ho která bankovní aplikace zobrazí. Někde uvidíte „Příspěvek", jinde „P?ísp?vek". Proto doporučujeme u zprávy i jména příjemce diakritiku vypustit; náš generátor to umí udělat za vás.
Stejný důvod stojí za malými písmeny. Standard je nezná, ale v praxi procházejí. Riziko je menší než u diakritiky, přesto: čím blíž k povolené sadě zůstanete, tím míň překvapení.
Chyby, které vidíme nejčastěji
| Hvězdička v textu | Zpráva typu „Faktura *2026*" řetězec rozbije. Generátor ji musí odstranit nebo odmítnout. |
|---|---|
| Částka s čárkou | AM:1250,00 je špatně. Desetinný oddělovač je tečka. |
| Částka s mezerami | AM:1 250.00 neprojde. Žádné oddělovače tisíců. |
| Variabilní symbol s písmeny | Symboly jsou číselné. „VS2026" není variabilní symbol. |
| Datum v českém tvaru | DT:22.09.2026 je špatně, správně DT:20260922. |
| Chybějící měna | Formálně je volitelná, ale bez ní musí aplikace hádat. Uvádějte CC:CZK. |
| Příliš dlouhá zpráva | Nad 60 znaků se text ořízne – a často zrovna tam, kde byla podstatná informace. |
Jaký QR kód se pro SPAYD používá
Dokumentace doporučuje úroveň korekce chyb M, tedy takovou, která snese poškození zhruba 15 % plochy kódu. Je to rozumný kompromis: vyšší úroveň kód zhustí a zhorší čitelnost z větší vzdálenosti, nižší zase hůř snáší zmačkaný papír.
Výjimka platí, když do kódu vkládáte logo – to zakryje část plochy, a proto se vyplatí sáhnout po nejvyšší úrovni. Víc o tom píšeme v návodu QR kód do tisku.
Jak si obsah kódu zkontrolovat
Nejrychlejší způsob, jak ověřit cizí i vlastní kód, je přečíst ho jako obyčejný text. Otevřete čtečku, nahrajte obrázek nebo namiřte kameru a podívejte se, co v kódu doopravdy je. Uvidíte přesně ten řetězec, který popisuje tenhle návod – a hned poznáte, jestli v něm třeba nechybí variabilní symbol.
Kde si to ověřit
Vývojářská dokumentace formátu je na qr-platba.cz, samotný standard vydává Česká bankovní asociace.
Naposledy zkontrolováno: 22. září 2026