Vylepšení fungování aktuálních QR plateb

V reakci na to se nám podařilo celý systém obalit dalšími kontrolami, aby QR platby napříč různými státy a měnami fungovaly co možná nejspolehlivěji. Můžeme potvrdit, že jsme funkčnost otestovali v rámci 3 různých bank a načtení jak českého, tak i zahraničního QR kódu proběhlo bez problémů.

Tento text přímo navazuje na náš dřívější článek Novinka: Rozšířené možnosti QR plateb pro zahraniční zákazníky, ve kterém jsme představili rozvržení do mezinárodních norem. Po spuštění nových formátů QR plateb jsme evidovali problémy s jejich načítáním u některých bankovních aplikací, které nesprávně vyhodnocovaly nepovinné údaje jako povinné a platbu zamítly. Z tohoto důvodu došlo v minulém týdnu k výraznému ladění a optimalizaci generátorů kódů u českých i zahraničních norem.

Jaké formáty jsou aktuálně k dispozici?

V nastavení plateb naleznete čtyři možnosti formátu QR platby s ohledem na cílovou destinaci a měnu:

1. Auto (automatická detekce podle měny a země)
   • Doporučujeme: Systém sám rozpozná, odkud zákazník je a v jaké měně platí, a podle toho vybere příslušný formát QR kódu.
2. ČR (Short Payment Descriptor)
   • Klasická česká norma SPAYD. Ideální, pokud prodáváte výhradně v Česku.
3. SK (Pay by square)
   • Slovenská norma. Nezbytná pro správné načtení QR kódu ve slovenských bankovních aplikacích. Využití je však teď dočasně přerušeno (viz výše).
   • Momentálně pozastavená
4. EURO (EPC QR Code)
   • Evropská norma pro SEPA platby. Umožní snadné platby zákazníkům z celé EU.

Ukázka technických formátů norem pro vývojáře

Pro ty z vás, kteří se zajímají o technické pozadí QR kódů, ukážeme i jak samotné vygenerované textové řetězce vypadají. Podobný skrytý text do vašeho počítače předá telefon po načtení foťákem.

ČR (SPAYD)

Jedná se o jeden dlouhý řetězec oddělený hvězdičkami. Podporuje například Variabilní symbol (X-VS), Specifický symbol (X-SS) i Konstantní symbol (X-KS).

SPD*1.0*ACC:CZ5855000000000000012345*AM:1234.00*CC:CZK*MSG:Objednavka 123*X-VS:2601234*CRC32:A1B2C3D4

EURO (EPC QR Code)

Evropská norma má úspornější formát přesně o 12 strukturovaných řádcích (rozdělených odřádkováním \n). Co řádek, to zapsaná hodnota. Zajímavostí je, že maximální povolená velikost obsahu je tvrdě omezena na 331 bajtů a název příjemce je zcela povinný (bez něj veškeré načtení selže). Pro SEPA je také nesmírně důležitý BIC kód.

BCD
002
1
SCT
FIOBCZPP
Název firmy s.r.o.
CZ5855000000000000012345
EUR1234.00

VS123456
Zpráva pro platbu

Poznámka: Slovenskou normu (Pay by square) zde prozatím jako text neuvádíme, protože vyžaduje ještě dodatečnou LZMA kompresi (složité zabalení do binárních dat kódu) před zakódováním, a na platformě je navíc dočasně pozastavena.

Správná měna je pro funkční platbu základ

Zabezpečit, aby platba proběhla bez problémů, znamená odesílat správnou měnu u správného formátu.

Doporučení pro EU QR je odesílat měnu EURO, zatímco pro CZ QR je doporučená česká koruna (CZK). Pokud kód vygenerujete s jinou měnou, než je pro daný formát běžné, praxe ukázala, že většina bankovních aplikací (českých i evropských) kód odmítne přijmout s hláškou, že je neplatný. Vždy proto bedlivě hlídejte jaká měna je k dané platbě aktivní.

Nejčastější situace s QR platbami a jak je řešit

V rámci podpory řešíme několik typických požadavků od zákazníků ze zahraničí. Přinášíme vám tipy na správná nastavení v administraci.

1. Jiná měna než CZK v rámci českého QR kódu

S výjimkou FIO banky, která si dle našich testů s tímto poradit zvládá, ostatní české banky u CZ QR kódu jinou měnu nepřijmou. Cizí měny pro tento formát kódu tedy nedoporučujeme.

2. Číslo účtů bez QR kódu pro cizince

Tento postup lze uplatnit bez problému napřímo, jediná zásadní podmínka je, že tato platba (pro zahraniční nakupující) nesmí být v nastavení způsobů plateb spárována na skript s "QR" platbou. V systému zkrátka vytvořte běžnou platbu převodem na účet a spárování s QR nepovolte.

3. EU QR kód pro jinou měnu než EURO (např. polský zlotý)

Doporučená měna pro SEPA platby s EU QR je EURO. Pokud pod ním rozešlete cizí měnu (PLN, HUF), záleží případ od případu, jak se s tím daná banka vypořádá. V mnohých případech banka zákazníka nedokáže data přečíst. Jedinou jistotou je doporučená měna EUR.

Jak tyto změny dostat do e-shopu?

Pravidla pro propsání všech oprav generátoru se liší od vaší licence.

• Odkoupené e-shopy a weby na měsíční platbu: Musíte si v administraci stáhnout a nainstalovat příslušné aktualizace obchodu.
• Pronajaté e-shopy: Změny a všechny novinky s aktualizacemi se u vás propisují plošně z našeho centra. Plně postačuje se přihlásit do administrace e-shopu, čímž si kód obnovíte.

Často kladené dotazy (FAQ)

Jaká je nejlepší měna pro generování EU QR kódu?

Absolutně nejspolehlivější měnou pro bezpečné vygenerování EU QR kódu bez chyb ze strany bank je výhradně EURO.

Z jakého důvodu se mým zákazníkům kódy nenačtou?

Sami jsme QR kódy otestovali ve 3 bankách a načte se bez problému jak český, tak i zahraniční kód. Většina chyb na straně zákazníků vzniká nevhodným překřížením správného QR kódu s nedoporučenou měnou v objednávce (vinou e-shopu), nebo spouští nekompatibilní případně starou aplikaci jejich banky.

Znamená to, že pro České koruny mají moji klienti platit evropským QR formátem?

Nikoliv. Pokud je měna zúčtování česká Koruna (CZK), spolehněte se vždy na klasický český (CZ) formát QR kódu. Není občas dobré je míchat - pro CZ formát je doporučeno CZK, pro EU formát naopak EUR.

Kdy se zlepší kompatibilita bank na nestandardní formáty?

Dle dostupných zdrojů zjišťujeme, že by se v období prázdnin měly naše banky plně přizpůsobit novému standardu pro EU QR platby. Pokud k tomu dojde, měla by zcela odpadnout řada současných potíží u čtení aplikací. Jedná se zatím o informaci z jedné strany a nenašli jsme druhý relevantní a důvěryhodný zdroj, každopádně je vysoce pravděpodobné, že se situace k létu razantně zlepší.

Jak nastavit QR jen pro Česko a schovat ho cizincům?

Zcela snadno si v administraci vytvoříte dvoufázový systém placení. V sekci Způsobu plateb si nastavte separátně jednu platbu jako "Bankovní převod (český)" a ten přes skript spárujte typem na "QR platba" - systém vygeneruje český QR pro české klienty. Druhou platbu vytvořte jako bankovní převod zacílený na cizince s tím, že ji zkrátka nepropojíte s QR skriptem.

Závěrem

Byť jsme minulý týden odvedli na odlaďování QR plateb velký kus práce a přinutili české banky kódy načíst i při drobných anomáliích, chceme nad stavem udržet dohled. Chceme od vás mít co možná nejživější zpětnou vazbu k fungování – máte-li vy nebo vaši zákazníci jakýkoliv technický problém, či pozorujete chybovost přímo od konkrétní banky z Česka i zahraničí, dejte nám vědět a kontaktujte zákaznickou podporu! Každé vaše hlášení chyb z praxe posune e-shop k lepším výsledkům! Děkujeme.

Související články a články stojící za připomenutí

Článek vytvořen za pomoci umělé inteligence, ať máme více prostoru pro vás.