Proč to potřebujete
Bankovní převod je pro e-shop nejlevnější platba, ale nejvíc práce. Zákazník opisuje číslo účtu a variabilní symbol, splete se v číslici a vy pak každé ráno procházíte výpis a ručně přepínáte objednávky na zaplacené. SemaQR z toho dělá platbu na pár kliknutí pro zákazníka a bez práce pro vás.
Co zákazník chce
- Naskenovat QR kód v bankovní aplikaci, nic neopisovat
- Mít QR kód i v e-mailu, když neplatí hned
- Vidět, že platba dorazila, bez telefonování do obchodu
- Dostat zboží hned, ne až po ruční kontrole výpisu
Co vás zdržuje u převodů
- Každodenní procházení výpisu a párování plateb
- Špatně opsaný variabilní symbol nebo částka
- Nedoplatky, přeplatky a platby na zrušené objednávky
- Odeslání zboží čeká, až se k výpisu někdo dostane
Co SemaQR řeší
Nainstalujete jeden ZIP, ve VirtueMartu založíte platební metodu, vyplníte IBAN a token Fio API a u hostingu nastavíte cron. Hotovo. Zaplacené objednávky se od té chvíle přepínají samy.
QR platba pro zákazníka
- QR kód ve formátu QR Platba — český standard SPAYD, který načte každá bankovní aplikace v ČR
- Na děkovací stránce, v detailu objednávky i v e-mailu — zákazník může zaplatit hned, nebo později z potvrzovacího e-mailu
- Uložení QR do telefonu — tlačítko „Uložit QR kód“, na iPhonu přes nabídku sdílení, aby šel kód otevřít v bankovní aplikaci
- Údaje pro ruční zadání — účet, částka, variabilní symbol a zpráva pro příjemce pod kódem
- Stav platby živě — děkovací stránka sama ukáže „Zaplaceno“, jakmile platbu spárujeme
Automatické ověření plateb
- Pohyby z Fio API — plugin stahuje příchozí platby přes token jen pro čtení
- Párování podle variabilního symbolu — s kontrolou částky, měny a nastavitelnou tolerancí
- Změna stavu objednávky — zaplacená objednávka přejde do zvoleného stavu a VirtueMart pošle zákazníkovi e-mail podle vašeho nastavení stavů
- Nedoplatek — vlastní stav, e-mail zákazníkovi a nový QR kód na zbývající částku; doplatky se sčítají
- Přeplatek a sporné platby — platba v jiné měně, na zrušenou objednávku nebo duplicitní přijde správci e-mailem k ruční kontrole
Administrace
- Ověřit platbu nyní — okamžitá synchronizace s bankou přímo z detailu objednávky
- Označit jako zaplaceno — ruční potvrzení, do historie objednávky se zapíše, kdo to udělal
- Nespárované platby — přehled příchozích plateb, které nešly přiřadit, s ručním spárováním nebo ignorováním
- Denní souhrn — volitelný e-mail se seznamem nespárovaných plateb
- Bezpečně uložený token — VirtueMart ho šifruje klíčem ze své bezpečné cesty
- Automatické aktualizace — přes SemaHub, přímo z administrace Joomly
Jak to funguje
Pro zákazníka
Zvolí QR platbu
V košíku vybere platbu QR kódem a dokončí objednávku jako obvykle.
Naskenuje QR kód
Na děkovací stránce nebo v e-mailu naskenuje kód bankovní aplikací. Účet, částka i variabilní symbol se vyplní samy.
Dostane potvrzení
Jakmile platba dorazí na účet, objednávka se přepne na zaplacenou a zákazníkovi přijde e-mail.
Pro provozovatele e-shopu
Cron stáhne pohyby
Každých pár minut si plugin vyžádá z Fio API nové příchozí platby.
Platby se spárují
Podle variabilního symbolu najde objednávku, zkontroluje částku a měnu a změní stav objednávky.
Vy jen odesíláte
Řešíte jen výjimky, které vám plugin pošle e-mailem: nedoplatky, přeplatky a platby, které nešly přiřadit.
Co vše lze nastavit
| Parametr | Popis |
|---|---|
| IBAN a BIC | Účet pro platby, IBAN se kontroluje |
| Měny | Metoda se nabídne jen v povolených měnách; pro další účet nebo měnu další instance |
| Variabilní symbol | Z čísla objednávky nebo z jejího ID |
| Zpráva pro příjemce | Šablona s číslem objednávky a názvem obchodu |
| Banka | Fio (s ověřením), nebo bez banky (jen QR kód) |
| Tolerance částky | Absolutní nebo v procentech |
| Stavy objednávky | Čeká na platbu, zaplaceno, nedoplatek |
| Upozornění správci | E-mail pro chyby banky, platby k ruční kontrole a denní souhrn |
| Děkovací stránka | Interval kontroly stavu, údaje pro ruční zadání |
Technické údaje
| Vlastnost | Hodnota |
|---|---|
| Typ rozšíření | VirtueMart payment plugin |
| Element | semaqr |
| Joomla | 4.x, 5.x |
| VirtueMart | 4.x |
| PHP | 8.1+ (rozšíření gd a openssl) |
| Formát QR | QR Platba (SPAYD) |
| Banka pro ověření | Fio banka (Fio API, token jen pro čtení) |
| Cron | Volání URL každé 2–5 minut (cron hostingu) |
| Jazyk | Čeština, angličtina |
| Licence | GPL v2+ |
| Automatické aktualizace | Ano (přes SemaHub) |
Časté dotazy
Musím mít účet u Fio banky?
Jen pro automatické ověření plateb. Bez Fio účtu plugin funguje v režimu „bez banky“: zákazník dostane QR kód a platby potvrzujete ručně tlačítkem v objednávce.
Podporujete i jiné banky?
Zatím ne. Ověření plateb dnes umí Fio API. Máte-li účet jinde a zájem o napojení, napište nám.
Má plugin přístup k penězům na účtu?
Ne. Token Fio API zakládáte s oprávněním jen pro čtení pohybů. Platby z něj odeslat nejde.
Jak rychle se objednávka přepne na zaplacenou?
Podle intervalu cronu a toho, kdy Fio platbu zaúčtuje. Mezi účty v rámci jedné banky a u okamžitých plateb to bývá několik minut.
Co když zákazník pošle méně?
Objednávka přejde do stavu „nedoplatek“, zákazník dostane e-mail a na webu vidí QR kód na zbývající částku. Doplatek se k první platbě přičte.
Co když zákazník zapomene variabilní symbol?
Platba se objeví v seznamu nespárovaných plateb a přiřadíte ji k objednávce jedním kliknutím. Při placení přes QR kód se to stát nemůže, symbol je v kódu.
Na účet mi chodí i jiné platby. Vadí to?
Ne. Platby, které nepatří k žádné objednávce, plugin jen zaznamená. Denní souhrn nespárovaných plateb můžete vypnout.
Můžu mít jeden účet pro dva e-shopy?
Ano, pokud se čísla objednávek (variabilní symboly) obou e-shopů nekříží. Fio API povoluje jeden dotaz na token za 30 sekund, synchronizace se proto mezi e-shopy sama rozestoupí.
Zvládne to můj hosting?
Stačí, když hosting umí cron, který volá adresu webu (Wedos, Forpsi, 4shop i vlastní server). URL včetně tajného klíče vám ukáže formulář platební metody.
Dostane zákazník QR kód i v e-mailu?
Ano, v potvrzení objednávky. Stav „čeká na platbu“ musí být mezi stavy, ve kterých VirtueMart posílá zákazníkovi e-mail (Konfigurace → Obchod).
Jak to vypadá v praxi
