--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret QR platby url: https://documentation.toret.cz/qr-platby/ date: 2024-06-21 modified: 2026-06-04 author: tcirkl type: page --- # Dokumentace pluginu Toret QR platby Nacházíte se na stránkách dokumentace pluginu QR platby, který zákazníkům nabízí možnost snadno zaplatit objednávku přes QR kód. Plugin QR platby zakoupíte zde: [Toret QR platby pro WooCommerce](https://toret.cz/produkt/qr-platby/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Nastavení platební metody a bankovních účtů 4. Nastavení variabilního symbolu 5. Nastavení QR kódu 6. Viditelnost platebních údajů 7. Viditelnost QR kódu 8. Jméno příjemce (pro SK) 9. Měna a viditelnost účtu 10. Vlastní děkovná stránka 11. Vlastní e-maily 12. QR kód na faktuře - Toret Faktura - - PDF Invoices & Packing Slips for WooCommerce - - WooCommerce PDF Invoicing and Packing Slips 13. Filtry 14. Řešení problémů - QR kód nelze načíst bankovní aplikací 15. Testování pluginu ## Instalace pluginu Po zakoupení pluginu obdržíte emailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete [zde](https://documentation.toret.cz/instalace-pluginu/). ## Aktivace pluginu Po instalaci pluginu si otevřete plugin QR platby (*Toret plugins → QR platby*), do příslušného pole vložte licenční klíč a tlačítkem aktivujte. ![Plugin Toret QR platby - aktivace](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-aktivace-1024x486.png "Plugin Toret QR platby - aktivace") ## Nastavení platební metody a bankovních účtů Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení. To se nachází pod kartou *Toret plugins → QR platby*. **Nastavení podporovaných platebních metod** Nejprve je nutné vybrat platební metodu/y pro platbu na účet, pro které se bude QR kód zobrazovat. Nastavení najdete v sekci *Bankovní účet a VS*. Více metod lze zvolit kliknutím a současným přidržením klávesy Ctrl. Plugin je kompatibilní s platební metodou bankovního převodu WooCommerce „bacs“ a také s platební metodou bankovního převodu z pluginů Toret „pnu“. Zvolit můžete též vlastní, obdobné metody. ![Plugin Toret QR platby - nastavení podporovaných platebních metod](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-podporovanych-platebnich-metod-1024x485.png "Plugin Toret QR platby - nastavení podporovaných platebních metod") **Zadání platebních údajů** U platebních metod, které jste zvolili v předchozím kroku, je nutné **nastavit informace o účtu.** To provedete v nastavení platebních metod WooCommerce. Příklad pro metodu Bankovním převodem: V nastavení platební metody bankovního převodu (WooCommerce > Nastavení > Platby > Přijímejte offline platby > Bankovní převod) je nutné vyplnit údaje o bankovním účtu. ![Toret QR platby – nastavení platební metody bankovního převodu](https://documentation.toret.cz/wp-content/uploads/2026/01/Toret-QR-platby-%E2%80%93-nastaveni-platebni-metody-bankovniho-prevodu.png "Toret QR platby – nastavení platební metody bankovního převodu") ## Nastavení variabilního symbolu V sekci *Variabilní symbol*si nastavte **zdroj, který bude použit jako variabilní symbol pro platbu převodem**(a). Dostupné zdroje jsou číslo nebo ID objednávky, údaje z kompatibilních pluginů nebo lze jako zdroj zvolit vlastní pole. ![Toret QR platby -nastavení variabilního symbolu](https://documentation.toret.cz/wp-content/uploads/2026/01/Toret-QR-platby-nastaveni-variabilniho-symbolu.png "Toret QR platby -nastavení variabilního symbolu") Plugin QR platby je kompatibilní s pluginy: - Custom Order Numbers for WooCommerce - Sequential Order Numbers for WooCommerce - Toret Order Numbers - Toret Faktura Dalším krokem je**zvolení úpravy variabilního symbolu**(b) Variabilní symbol se skládá pouze z číslic a jeho maximální délka je 10 znaků. Pokud používáte plugin pro vlastní číslování, které umožňuje i písmena, je nutné zvolit jednu z následujících úprav. **Vynechat písmena:** Po nastavení této varianty se Vám propíše do variabilního symbolu číslo objednávky bez písmen. --- **Pouze číslo objednávky ve zprávě: **Při tomto nastavení se nepropíše číslo objednávky do variabilního symbolu, ale propíše se do poznámky nebo popisu platby a to včetně písmen, které jsou součástí čísla objednávky. --- ## Nastavení QR kódu V další části nastavení pluginu je možné upravit jeho zobrazení: - přidat vlastní text pod nebo nad QR kód, včetně vlastních stylů - přidat vlastní styly pro QR kód - povolit zobrazení doprovodných textů na děkovné stránce a v e-mailu - nastavit zprávu pro příjemce: Zde si můžete upravit vlastní text, který se automaticky vyplní jako poznámka pro příjemce. V poznámce můžete použít proměnné. Maximální délka je 60 znaků. Pokud necháte pole prázdné, tak se žádná poznámka do platby nepropíše. - nastavit velikost QR kódu ![Plugin Toret QR platby - nastavení QR kódu](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-QR-kodu.png "Plugin Toret QR platby - nastavení QR kódu") Příklad přidaných textů u QR kódu. ![Plugin Toret QR platby - příklad zobrazení QR kódu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-qr-platby-qr-kod.png "Plugin Toret QR platby - příklad zobrazení QR kódu") ## Viditelnost platebních údajů Kromě QR kódu lze zákazníkům zobrazovat i platební údaje (číslo účtu, IBAN, BIC, VS). V této části nastavíte zda a jaké platební údaje se budou zákazníkům zobrazovat v e-mailech a na děkovné stránce. Tyto údaje pomohou zákazníkům zaplatit, např. pokud se jim nepodaří načíst QR kód. ![Plugin Toret QR platby - nastavení viditelnosti platebních údajů](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-viditelnosti-platebnich-udaju.png "Plugin Toret QR platby - nastavení viditelnosti platebních údajů") Sekce Metabox objednávky umožňuje zvolit, zda uvidíte platební údaje v detailu objednávky u všech metod platby nebo pouze u objednávek s platbou QR kódem. ## Viditelnost QR kódu QR kód je možné zákazníkovi zobrazovat podle potřeby. V pluginu lze nastavit zobrazení QR kódu: - V e-mailu odeslaném při stavu objednávky Čeká na vyřízení (On hold) - V e-mailu odeslaném při stavu objednávky Zpracovává se (Processing) - V e-mailu odeslaném ve vybraných stavech objednávky - Kombinace těchto možností - Na děkovné stránce Zobrazení QR kódu můžete **povolit/zakázat pro konkrétní bankovní účty** (sekce *Viditelnost QR kódu u účtu*). ![Plugin Toret QR platby - nastavení viditelnosti QR kódu](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-viditelnosti-QR-kodu.png "Plugin Toret QR platby - nastavení viditelnosti QR kódu") **Zobrazení na děkovné stránce**lze upravit: - vybrat háček (hook) pro umístění na děkovné stránce - zobrazit QR před platební údaji nebo pod nimi ## Jméno příjemce (pro SK) Pro QR platby prováděné plátcem ze slovenských bank je vyžadováno jméno příjemce platby (tzn. účtu vašeho e-shopu). V sekci Jméno příjemce lze vyplnit příjemce pro každý ze zadaných účtů v sekci *Bankovní účet a VS.* ![Plugin Toret QR platby - nastavení jména příjemce](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-jmena-prijemce-1024x524.png "Plugin Toret QR platby - nastavení jména příjemce") ## Měna a viditelnost účtu (Toret Plugins > QR platby > Viditelnost účtu) V případě, že používáte na e-shopu více měn a k tomu i více bankovních účtů, můžete si nyní v nastavení pluginu povolit funkci ***Zobrazit účet pouze pro vybranou měnu*** a generovat QR kód / platební údaje s účtem pro použitou měnu v objednávce. Namísto zobrazení všech QR kódů pro všechny zadané bankovní účty se **zobrazí jen ten QR kód, na který chcete platbu v dané měně uhradit**. Pozor! Plugin QR platby generuje QR kódy pouze pro české koruny a eura. Pro jiné měny se zobrazí pouze platební údaje bez QR kódu. Po aktivaci funkce přiřaďte ke každému účtu měnu, pro kterou jej chcete používat. Pokud používáte více měn, než máte bankovních účtů, můžete si nastavit i **Výchozí účet pro jiné měny**, který bude u objednávek v nepřiřazené měně použit. Zobrazení QR kódu / platebních údajů lze také **podmínit zemí a jazykem zákazníka.**Pokud necháte pole prázdná, zobrazí se vždy. ![Plugin Toret QR platby - nastavení měny účtu](https://documentation.toret.cz/wp-content/uploads/2026/03/Plugin-Toret-QR-platby-nastaveni-meny-uctu.png "Plugin Toret QR platby - nastavení měny účtu") ## Vlastní děkovná stránka Výchozí děkovná stránka WooCommerce obsahuje hook pro zobrazení QR kódu. Pokud používáte vlastní děkovnou stránku, která tento hook neobsahuje, QR kód se nezobrazí. Pokud chcete QR kód zobrazovat i na vlastní děkovné stránce, můžete využít shortcode, který do vlastní děkovné stránky vložíte na místo, kde chcete QR kód zobrazit. Do své děkovné stránky vložte shortcode: **tqr_thankyou_shortcode** ## Vlastní e-maily V případě, že používáte vlastní e-maily pomocí pluginu třetí strany nebo máte e-maily upravené, nemusí se QR kód v e-mailu zobrazovat. Pokud je tomu tak, zkontrolujte zda e-maily obsahují hook **woocommerce_email_before_order_table**, na který je QR kód vázán, a případně hook doplňte v e-mailu na místo, kde chcete QR kód zobrazit. Zobrazení QR kódu může také blokovat samotný e-mailový klient, který blokuje obrázky z externích zdrojů. Načítání obrázků z externích zdrojů se může povolit na úrovni celého e-mailového klienta nebo na úrovni konkrétního e-mailu. Nicméně toto povolení je na straně uživatelů e-mailu. Blokování obrázků z externích zdrojů plošně neovlivníte. ## QR kód na faktuře Plugin QR platby je kompatibilní s fakturačními pluginy Toret Faktura, PDF Invoices & Packing Slips for WooCommerce a WooCommerce PDF Invoicing and Packing Slips. Na faktury z těchto pluginů můžete přidat QR kód. Vše nastavíte v sekci *Pluginy pro fakturaci.* ### Toret Faktura Zobrazení QR kódu na pluginu Toret Faktura stačí povolit zatržením checkboxu. ![Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu Toret Faktura](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-QR-kodu-na-fakture-z-pluginu-Toret-Faktura-1024x500.png "Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu Toret Faktura") ### PDF Invoices & Packing Slips for WooCommerce Na fakturu generovanou pluginem PDF Invoices & Packing Slips for WooCommerce umístíte QR kód vybráním hooku (a). Následně je možné upravit doprovodné texty a styly. ![Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu PDF Invoices a Packing Slips for WooCommerce](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-QR-kodu-na-fakture-z-pluginu-PDF-Invoices-a-Packing-Slips-for-WooCommerce.png "Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu PDF Invoices a Packing Slips for WooCommerce") ### WooCommerce PDF Invoicing and Packing Slips Při použití pluginu WooCommerce PDF Invoicing and Packing Slips je třeba do šablony faktury vložit shortcode (a). Následně je možné upravit doprovodné texty a styly. ![Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu WooCommerce PDF Invoicing and Packing Slips](https://documentation.toret.cz/wp-content/uploads/2026/01/Plugin-Toret-QR-platby-nastaveni-QR-kodu-na-fakture-z-pluginu-WooCommerce-PDF-Invoicing-and-Packing-Slips.png "Plugin Toret QR platby - nastavení QR kódu na faktuře z pluginu WooCommerce PDF Invoicing and Packing Slips") ## Filtry tqp_allowed_payment_methods_email (pro úpravu povolených platebních metod pro zobrazení QR kódu v e-mailu) --- tqp_email_payment_method (pro možnost změnit zobrazenou platební metodu objednávky v e-mailu) --- tqr_text_before_thankyou, tqr_text_after_thankyou (pro úpravu textů před a za QR kódem na děkovné stránce) --- tqr_text_before_emai, tqr_text_after_email (pro úpravu textů před a za QR kódem v e-mailu) --- ## Testování pluginu Pro účely testování můžete využít: - subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web) - localhost (127.0.0.1) Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání. ## Řešení problémů ### QR kód nelze načíst bankovní aplikací Příčin, proč bankovní aplikace nemůže načíst QR kód, může být vícero: **QR kód je zobrazen na jiném než bílém pozadí** Zejména slovenské qr kódy vyžadují bílé pozadí včetně prázdného rámečku okolo (tzv. quiet zone). Pokud je QR kód zobrazen na jiném pozadí, nemusí jej bankovní aplikace načíst. **Odlišný standard pro české a slovenské QR kódy** QR kódy pro české a slovenské transakce mají odlišné standardy. Proto většina českých bankovních aplikací nenačítá slovenské qr kódy a naopak. Plugin automaticky generuje QR kódy ve standardu podle země (CZ/SK) vyplněné zákazníkem v pokladně.