QR platby.
Slovensko aj Česko.

VYBERTE SI PLATOBNÝ ŠTANDARD

Dve krajiny. Vlastný formát pre každú.

SKSlovensko · EUR

PAY by square

Slovenský platobný formát s možnosťou rámčeka, loga pod kódom alebo čistého QR obrázka.

O štandarde PAY by square ↗

CZČesko · CZK

QR Platba

Český platobný formát SPAYD. Predvolene s rámčekom a označením „QR platba“, aby zákazník rozpoznal platobný kód.

Validátor formátu SPAYD ↗

Ukážky obsahujú testovacie platobné údaje. Platbu neodosielajte. Prefixy sk a cz označujú platobný štandard.

QR KÓD NA SKUTOČNEJ FAKTÚRE

Veľkosť, okraje a čitateľnosť.

Rovnaká platba môže vyzerať odlišne podľa veľkosti obrázka a spôsobu vloženia do dokumentu. Overujte výslednú faktúru, nielen samostatný QR súbor.

Zmenšovať je zvyčajne lepšie než zväčšovať

Pre väčšie zobrazenie vytvorte dostatočne veľký PNG a podľa potreby ho zmenšite. Napríklad pre priestor približne 400 px začnite s obrázkom 512 px. Zväčšenie malého 128 px obrázka môže rozmazať hranice modulov. Aj zmenšovanie môže pri nevhodnom pomere zhoršiť čitateľnosť; ideálne zachovajte celé pixely na modul.

Oba obrázky zobrazujú rovnaké testovacie údaje v rovnakej šírke 256 CSS px, pokiaľ to šírka obrazovky umožňuje. Spôsob vyhladzovania závisí od prehliadača a displeja.

<img src="URL_VÁŠHO_QR_OBRÁZKA"
     width="256"
     style="height: auto"
     alt="QR kód pre úhradu faktúry">

Všetky možnosti vykresľovania

Base64 používa rovnaký render ako obrazový výstup. Parameter unit_size patrí k raw výstupu; v Base64 používajte size.

Český účet: IBAN aj domáce číslo

Parameter iban prijíma výhradne IBAN. Do bank_account môžete vložiť IBAN alebo české číslo účtu s kódom banky. Platí pre obrázky, raw, Base64 aj platobný reťazec. QR vždy obsahuje výsledný IBAN.

GET /cz/qr-platba.png?bank_account=19-2000145399%2F0800&amount=10
GET /cz/qr-platba.png?bank_account=1265098001%2F5500&amount=10
GET /cz/qr-platba.png?bank_account=CZ6508000000192000145399&amount=10

Medzery sa odstránia, malé písmená IBANu sa prevedú na veľké. Domáci formát potrebuje štvormiestny kód banky; predčíslie má najviac šesť číslic a číslo účtu najviac desať. Predčíslie možno vynechať. API kontroluje kontrolné súčty a prevádza účet lokálne, bez externých služieb. Napríklad 19-2000145399/0800 prevedie na CZ6508000000192000145399.

Zadajte aspoň jeden z parametrov. Ak pošlete oba, musia byť platné a označovať rovnaký účet. Neplatný iban sa nenahradí hodnotou bank_account. Chýbajúci kód banky sa neodhaduje. Kontrola nepotvrdzuje existenciu ani vlastníctvo účtu. Chyby sa riadia nastavením on_invalid; pri ladení použite on_invalid=error. Slovenské API zostáva bez zmeny.

Česká QR Platba: s rámčekom alebo bez

Obrazové a Base64 výstupy predvolene používajú mode=full. Rámček a označenie vychádzajú z oficiálneho grafického manuálu QR Platba. Štvormodulová biela tichá zóna zostáva zachovaná. Ak potrebujete pôvodný čistý obrázok, pridajte mode=none. Platobné údaje sa nemenia.

GET /cz/qr-platba.png?iban=CZ6508000000192000145399&amount=10&mode=full
GET /cz/qr-platba.png?iban=CZ6508000000192000145399&amount=10&mode=none
GET /cz/qr-platba/raw.png?iban=CZ6508000000192000145399&amount=10&unit_size=5

Rovnaké možnosti platia pre PNG, JPEG aj BMP. Pri rovnakej hodnote size zaberie rámček časť plátna, takže samotný QR môže byť menší. Pre dlhšie údaje zvýšte size; ak nevychádzajú aspoň dva pixely na modul, uplatní sa on_invalid. raw zostáva bez rámčeka.

Neplatné údaje a prázdny obrázok (CZ)

České obrazové endpointy vrátane raw predvolene používajú on_invalid=empty. Pri chybe validácie vrátia HTTP 200 a platný obrázok 1 × 1 px: priehľadný PNG alebo biely JPEG/BMP. Faktúra tak nemusí zobrazovať ikonu poškodeného obrázka. Odpoveď sa neukladá do cache (Cache-Control: no-store). HTTP 200 preto samo osebe nepotvrdzuje platnosť platobných údajov.

Pri ladení použite on_invalid=error: API vráti HTTP 400 s vysvetlením. Túto možnosť používa aj galéria. Neznáma hodnota on_invalid alebo nepodporovaný formát vždy vrátia 400. Neočakávané chyby servera zostávajú HTTP 500. Base64 a platobný reťazec naďalej vracajú chyby validácie; slovenské endpointy sa nemenia.

GET /cz/qr-platba.png?iban=INVALID
GET /cz/qr-platba.png?iban=INVALID&on_invalid=error

V editore faktúry odporúčame vysvetliť chýbajúci QR kód, napríklad upozornením na neplatný IBAN. Prázdny obrázok je určený pre čistý výstup faktúry, nie ako náhrada validácie údajov vo vašej aplikácii.

Base64 a platobný reťazec

Base64 endpoint vracia JSON s mime, data (Base64 obrázok) a dimensions. Do HTML ho vložíte ako data:image/png;base64,…; pri inom formáte použite prijatú MIME hodnotu. Pole dimensions obsahuje údaje o moduloch. Pri CZ označuje size rozmer celého štvorcového plátna, qr_width šírku QR vrátane tichej zóny a offset jeho odsadenie od horného a ľavého okraja. Pri SK rámčeku sa konečné rozmery obrázka môžu líšiť od rozmerov samotného QR.

GET /sk/by-square/base64?format=png&iban=SK8975000000000012345671&amount=10&size=256
GET /cz/qr-platba/base64?format=png&iban=CZ6508000000192000145399&amount=10&size=256

Endpoint string vracia JSON s poľom data, ktoré obsahuje platobný reťazec pre vlastné vykresľovanie QR. Nejde o Base64 obrázok.

GET /sk/by-square/string?iban=SK8975000000000012345671&amount=10
GET /cz/qr-platba/string?iban=CZ6508000000192000145399&amount=10

Overenie pred nasadením

1. Skontrolujte IBAN, menu, sumu, symboly a dátum splatnosti po naskenovaní.
2. Použite krátke aj dlhšie poznámky. Viac údajov znamená hustejší QR kód a môže vyžadovať väčší obrázok.
3. Otestujte finálne PDF alebo výtlačok v bankových aplikáciách, ktoré používajú vaši zákazníci.
4. Český platobný reťazec skontrolujte aj v oficiálnom validátore SPAYD. Validný reťazec sám osebe nepotvrdzuje čitateľnosť obrázka.

Otvoriť galériu všetkých variantov →