QR Payment je plugin pro nopCommerce, který zákazníkům zjednoduší úhradu objednávky bankovním převodem. Po dokončení nákupu stačí v mobilním bankovnictví naskenovat QR kód – platební příkaz se vyplní sám, včetně čísla účtu, částky a variabilního symbolu. Bez ručního opisování údajů a bez rizika překlepu. Plugin podporuje český standard QR Platba (SPAYD) i slovenský PAY by square a QR kód zobrazí na stránce dokončené objednávky i v e-mailu s platebními pokyny.
Co plugin umí
- QR Platba (CZ) i PAY by square (SK) – oba bankovní standardy v jednom pluginu, každý lze zapnout samostatně.
- QR kód hned po nákupu – na stránce „Objednávka dokončena" s krátkým návodem, takže zákazník může zaplatit okamžitě.
- E-mail s platebními pokyny – číslo účtu nebo IBAN, částka, variabilní symbol a QR kód v samostatné zprávě.
- 5 tokenů pro šablony zpráv – platební údaje i QR kód vložíte také do dalších e-mailů k objednávce.
- Automatický výběr standardu podle měny – při zapnutí obou služeb jdou objednávky v EUR přes PAY by square, ostatní měny přes QR Platbu.
- Ochrana před opakovanou platbou – QR kód PAY by square přestane být dostupný po zaplacení nebo stornování objednávky.
- Objednávku nic nezablokuje – chybějící údaje ani výpadek externí služby nezastaví dokončení objednávky ani odeslání e-mailů.
- Multi-store a 3 jazyky – samostatné nastavení pro každý obchod, texty v češtině, slovenštině a angličtině.
- Upgrade-safe – samostatný plugin bez zásahu do jádra, šablony i databáze.
Jak QR platba funguje
Zákazník dokončí objednávku
V pokladně zvolí platební metodu, pro kterou máte QR platby zapnuté – typicky bankovní převod.
Zobrazí se QR kód
Na stránce dokončené objednávky uvidí QR kód s platebními údaji a krátký návod. Současně může dostat e-mail s platebními pokyny a stejným QR kódem.
Naskenuje ho v bankovnictví
Mobilní bankovní aplikace QR kód načte a sama předvyplní platební příkaz – účet nebo IBAN, částku, variabilní symbol i zprávu pro příjemce.
Zkontroluje a potvrdí
Zákazník údaje jen zkontroluje a platbu odešle. Se správnou částkou a variabilním symbolem se platba snadno spáruje s objednávkou.
QR Platba a PAY by square v jednom pluginu
QR Platba je český standard České bankovní asociace pro sdílení platebních údajů ve formátu SPAYD – QR kódy načítají mobilní aplikace českých bank. PAY by square je jeho slovenský protějšek, se kterým pracují aplikace slovenských bank. Plugin umí oba a pro každý obchod je zapnete nezávisle.
| Funkce | QR Platba (CZ) | PAY by square (SK) |
|---|
| Bankovní údaje | České číslo účtu | IBAN, volitelně BIC |
| Částka objednávky | Ano | Ano |
| Variabilní symbol | Ano | Ano |
| Zpráva pro příjemce | Ano | Ano |
| Údaje o příjemci | – | Název a adresa |
| Konstantní symbol | – | Volitelně |
| Datum splatnosti | – | Volitelně |
| Generování QR obrázku | Služba Paylibo (API) | Lokálně na serveru e-shopu |
Inteligentní výběr QR služby
Plugin sám rozhodne, který standard použít – podle zapnutých služeb a měny objednávky:
- Jen QR Platba → použije se český standard.
- Jen PAY by square → použije se slovenský standard.
- Obě služby → objednávky v EUR přes PAY by square, ostatní měny přes QR Platbu.
- Žádná služba → QR kód se nezobrazuje.
Bezpečné selhání: pokud chybí povinné bankovní údaje nebo je konfigurace neplatná, QR kód se jednoduše vynechá. Dokončení objednávky ani odeslání ostatních e-mailů tím není blokováno.
Kde zákazník QR kód uvidí
Po dokončení objednávky
QR kód s krátkým návodem a upozorněním na kontrolu údajů. Vkládá se přes standardní widget zónu checkout_completed_top – bez úprav šablony.
V e-mailu s pokyny
Šablona QRPayment.OrderCompletedNotification se vytvoří automaticky: číslo objednávky, částka, účet nebo IBAN, variabilní symbol, QR kód a vaše vlastní pokyny.
V dalších zprávách
Platební údaje a QR kód vložíte pomocí tokenů do libovolné další e-mailové šablony související s objednávkou.
E-mailovou šablonu upravíte ve standardní administraci nopCommerce mezi šablonami zpráv. Vaše úpravy zůstanou zachovány i při aktualizaci pluginu.
Tokeny pro e-mailové šablony
| Token | Popis |
|---|
%Order.QRCodeUrl% | URL obrázku QR kódu |
%Order.QRTotalSum% | Celková částka objednávky v měně zákazníka |
%Order.QRBankAccount% | Číslo účtu nebo IBAN |
%Order.QRVariableSymbol% | Variabilní symbol |
%Order.QRServiceName% | Název použité QR služby |
Jak se QR kódy generují
PAY by square – přímo na serveru, bez externí služby
- Generování podle specifikace PAY by square 1.2.0 přímo na serveru e-shopu – bez instalace dalšího softwaru.
- Žádné externí API, API klíče ani poplatky za jednotlivě vytvořené QR kódy.
- PNG obrázek s oficiálním rámečkem PAY by square, generovaný v paměti bez ukládání na disk.
- Kontrola stavu objednávky při každém načtení QR kódu – po zaplacení nebo stornování přestane být dostupný.
- Náhled v administraci – vygenerujete testovací QR kód na 1,00 EUR a ověříte ho ve své bankovní aplikaci.
QR Platba – přes službu Paylibo
Český QR kód generuje služba Paylibo. Obrázek načítá přímo prohlížeč nebo e-mailový klient zákazníka – ne server e-shopu při zpracování objednávky. Případná nedostupnost služby proto neblokuje vytvoření objednávky ani odeslání e-mailů; pokud se obrázek nepodaří načíst, QR blok se na stránce dokončené objednávky skryje.
Nastavení v administraci
Vše nastavíte bez zásahu do kódu v nabídce Administrace → NopShop → QR platby, rozdělené do tří sekcí:
Obecná nastavení
- Platební metody, u kterých se QR kód zobrazí
- Konfigurace pro jednotlivé obchody
- Přehled aktivních služeb a upozornění na chybějící údaje
QR Platba (CZ)
- Zapnutí / vypnutí služby
- Číslo účtu v českém formátu
- Zpráva pro příjemce (max. 60 znaků)
- Globální URL Paylibo API
PAY by square (SK)
- Zapnutí / vypnutí služby
- IBAN s kontrolou platnosti, volitelně BIC
- Název a adresa příjemce
- Poznámka k platbě se zástupným symbolem
{OrderNumber} - Volitelně konstantní symbol a splatnost od data objednávky
- Náhled testovacího QR kódu
Většinu nastavení lze přepsat pro každý obchod zvlášť pomocí standardního store-scope override systému nopCommerce.
Kvalita a technické parametry
Platby jsou citlivá část e-shopu, proto je plugin postavený tak, aby objednávkový proces neohrozil – a jeho funkčnost hlídají automatické testy.
2bankovní standardy (CZ + SK)
5tokenů pro šablony zpráv
3jazyky – CS, SK, EN
198automatických testů
| Parametr | Hodnota |
|---|
| Zásah do jádra / grafické šablony | Žádný – samostatný plugin |
| Integrace | Standardní widget zóny a události nopCommerce |
| Databáze | Žádné vlastní tabulky |
| PAY by square | Lokální generování dle specifikace 1.2.0, PNG v paměti |
| QR Platba | Paylibo API – obrázek načítá klient zákazníka |
| Zabezpečení | Kontrola oprávnění, ochrana CSRF, transakční ukládání konfigurace |
| Multi-store | Ano – store-scope override |
| Jazyky | CS, SK, EN (ostatní jazyky → EN); e-mailová šablona CS + SK |
| Testy | 198 automatických testů |
Instalace a požadavky
Plugin se instaluje standardně přes administraci nopCommerce. Při první instalaci vytvoří lokalizační texty a e-mailovou šablonu; QR Platba je ve výchozím stavu zapnutá, PAY by square vypnutý. Aktualizace zachová nastavení, vypnuté služby i vaše úpravy e-mailové šablony.
Co budete potřebovat
- Alespoň jednu podporovanou platební metodu, například bankovní převod.
- Pro QR Platbu platné české číslo bankovního účtu.
- Pro PAY by square platný IBAN, název příjemce a správně nastavenou URL obchodu.
Komu se hodí
Každému e-shopu na nopCommerce, který přijímá platby bankovním převodem – zejména v Česku a na Slovensku. Největší přínos má pro obchody, které prodávají do obou zemí v CZK i EUR, a pro ty, které chtějí méně chybně zadaných plateb a rychlejší úhradu objednávek. QR platba je zároveň oblíbený doplněk k platební bráně – převod nezatěžuje obchod transakčními poplatky brány.
Platba za pár sekund
Naskenovat, zkontrolovat, potvrdit – bez opisování čísla účtu.
Méně chybných plateb
Správná částka i variabilní symbol – snazší párování plateb s objednávkami.
Česko i Slovensko
QR Platba i PAY by square, CZK i EUR v jednom pluginu.
Bezpečné a upgrade-safe
Chyby QR kódu neblokují objednávky, žádný zásah do jádra.
Kompatibilita & licence: verzi nopCommerce zvolíte při objednávce – pokud ji plugin zatím nepodporuje, převedeme ho na vyžádání. Licence na jednu doménu nebo na více domén. Volitelně zajistíme instalaci a základní nastavení pluginu.
Související pluginy
Úprava na míru
Potřebujete QR kód zobrazit i jinde (například v detailu objednávky), přidat další bankovní údaje nebo upravit podobu e-mailu? Plugin přizpůsobíme vašemu e-shopu. Napište nám a navrhneme řešení.
Časté dotazy
Jak funguje platba QR kódem v e-shopu?
Po dokončení objednávky se zákazníkovi zobrazí QR kód s platebními údaji a stejný kód dostane e-mailem. Naskenuje ho v mobilním bankovnictví, aplikace sama vyplní číslo účtu, částku a variabilní symbol a zákazník platbu jen zkontroluje a potvrdí.
Jaký je rozdíl mezi QR Platbou a PAY by square?
QR Platba (formát SPAYD) je český standard pro české účty, PAY by square je slovenský standard pracující s IBAN. PAY by square navíc nese název a adresu příjemce, volitelně konstantní symbol a datum splatnosti. Plugin podporuje oba.
Který standard se použije, když zapnu oba?
Pro objednávky v EUR se použije PAY by square, pro všechny ostatní měny QR Platba. Když je zapnutá jen jedna služba, použije se vždy ta.
Pro jaké platební metody se QR kód zobrazí?
Pro ty, které vyberete v nastavení pluginu – typicky bankovní převod. Pro ostatní platební metody (např. kartou přes bránu) se QR kód nezobrazuje.
Může zákazník zaplatit objednávku dvakrát?
U PAY by square tomu plugin brání: stav objednávky se kontroluje při každém načtení QR kódu a po zaplacení nebo stornování přestane být QR kód dostupný.
Co když chybí bankovní údaje nebo nefunguje externí služba?
QR kód se jednoduše vynechá. Dokončení objednávky ani odeslání e-mailů to neblokuje. Obrázek QR Platby navíc načítá až prohlížeč nebo e-mailový klient zákazníka, takže výpadek služby Paylibo zpracování objednávky neovlivní.
Platím za vygenerované QR kódy nebo potřebuji API klíč?
U PAY by square ne – QR kódy se generují přímo na serveru e-shopu podle specifikace 1.2.0, bez externího API, API klíčů a poplatků za jednotlivé kódy. QR Platbu generuje služba Paylibo, jejíž URL je v nastavení.
Mohu QR kód a platební údaje vložit do vlastních e-mailů?
Ano. Plugin přidává 5 tokenů (%Order.QRCodeUrl%, %Order.QRTotalSum%, %Order.QRBankAccount%, %Order.QRVariableSymbol%, %Order.QRServiceName%), které vložíte do dalších e-mailových šablon k objednávce.
Funguje plugin ve více obchodech a jazycích?
Ano. Služby i většinu nastavení lze nastavit pro každý obchod zvlášť (multi-store). Texty administrace i zákaznické části jsou v češtině, slovenštině a angličtině; ostatní jazyky používají angličtinu.
PAY by square je ochranná známka společnosti ADELANTE, s.r.o.
