Co je SPAYD

Formát, ve kterém je zapsaná každá česká QR platba. Rozebraný pole po poli – pro účetní, vývojáře i zvědavé.

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 2026042

Skládá se ze tří částí:

  1. SPD – pevná hlavička, podle které aplikace pozná, že jde o platební údaje.
  2. 1.0 – verze formátu.
  3. 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Částkanejvýše 10 znaků, max. 2 desetinná místa, tečka jako oddělovač
CCMěna podle ISO 4217právě 3 znaky, pro tuzemské platby CZK
RNJméno příjemcenejvýše 35 znaků
MSGZpráva pro příjemcenejvýše 60 znaků
DTDatum splatnostiprávě 8 znaků ve tvaru RRRRMMDD
X-VSVariabilní symbolnejvýše 10 číslic
X-SSSpecifický symbolnejvýše 10 číslic
X-KSKonstantní symbolnejvýš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; hodnota IP označuje okamžitou platbu.
  • NT a NTA – žá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 textuZpráva typu „Faktura *2026*" řetězec rozbije. Generátor ji musí odstranit nebo odmítnout.
Částka s čárkouAM:1250,00 je špatně. Desetinný oddělovač je tečka.
Částka s mezeramiAM:1 250.00 neprojde. Žádné oddělovače tisíců.
Variabilní symbol s písmenySymboly jsou číselné. „VS2026" není variabilní symbol.
Datum v českém tvaruDT:22.09.2026 je špatně, správně DT:20260922.
Chybějící měnaFormálně je volitelná, ale bez ní musí aplikace hádat. Uvádějte CC:CZK.
Příliš dlouhá zprávaNad 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.

Vytvořit QR platbu →

Naposledy zkontrolováno: 22. září 2026