Popis produktu

FIO Banka – automatické párování příchozích plateb pro PrestaShop

Modul pro PrestaShop, který se místo vás dívá na účet. Každých pár minut stáhne přes oficiální FIO API nové pohyby, najde k nim objednávky podle variabilního symbolu, přepne jejich stav a pohlídá přeplatky i nedoplatky. Ranní rituál „otevřít bankovnictví a odklikat platby" tím končí.

Platba předem na účet je u českých zákazníků stále jedna z nejoblíbenějších plateb – a zároveň ta nejpracnější pro obchodníka. Tento modul celý proces automatizuje: od stažení pohybu z banky po e-mail zákazníkovi, že jeho platba dorazila. Vy jen občas mrknete na dashboard, jestli svítí zeleně.

Co modul umí

Více účtů a měn bez omezení

Prodáváte v korunách i eurech? Fio vede pro každou měnu samostatný účet a modul to respektuje: přidáte libovolný počet účtů, každý s vlastním API tokenem vygenerovaným v internetbankingu (stačí práva „pouze sledovat účet"). Tokeny se v administraci zobrazují maskované a u každého účtu je tlačítko Test spojení, které okamžitě prověří, že token funguje – včetně srozumitelné diagnózy, když nefunguje (prošlá platnost, omezení na jinou IP, překročený limit dotazů).

Párování podle variabilního symbolu – tak, jak ho používáte vy

Jako VS může sloužit ID objednávky, reference objednávky nebo číslo faktury (včetně podpory číselného prefixu faktur) – případně modul zkusí všechny údaje najednou. U zahraničních plateb, kde banka pole VS nevyplní, umí modul číslo dohledat i ve zprávě pro příjemce a komentáři. Volitelná tolerance do 1 Kč odpouští zákazníkům zaokrouhlené částky. Platby z vyjmenovaných protiúčtů (třeba vlastní převody mezi účty) lze ignorovat.

Stavy objednávek pod vaší kontrolou

Instalace vytvoří dva nové stavy – FIO Banka – Nedoplatek a FIO Banka – Přeplatek – které vidíte jen vy v administraci; zákazníka jimi strašit nemusíte. Používat je ale nemusíte: v přehledné mapě stavů určíte pro každý existující stav objednávky, kam se má přepnout po přijetí správné platby. Typicky „Čeká se na přijetí bezhotovostní platby" → „Platba byla přijata", ale klidně i párování dobírek se změnou na „Doručeno". Nejste ničím omezeni – a co v mapě nenastavíte, toho se modul nedotkne.

Přehled plateb přímo v administraci

V menu Objednávky přibude položka Příchozí platby z FIO: všechny pohyby s filtrováním, částkou, měnou, VS, zprávou i protiúčtem – rychlá kontrola účtu bez přihlašování do bankovnictví. Když zákazník splete variabilní symbol, opravíte ho přímo v přehledu a modul platbu ihned přepáruje; případně objednávku přiřadíte ručně bez ohledu na VS. Spárované platby se zobrazují i v detailu objednávky včetně ID bankovní transakce. Nad přehledem svítí čas poslední aktualizace – zeleně, dokud je čerstvá, červeně když je starší než 24 hodin (typicky zapomenutý CRON).

Dashboard widget

Hned na úvodní stránce administrace vidíte stav párování: režim modulu, čas poslední aktualizace se stejným barevným semaforem a počty přijatých plateb za posledních 24 hodin a 7 dní. Jeden pohled ráno a víte, že peníze tečou.

E-mailový servis

Volitelně vám modul pošle e-mail o každé nové platbě na účtu (částka, měna, od koho) a/nebo o každém provedeném spárování (objednávka, částka, nový stav). Přehled o penězích tak máte i v poště, aniž byste otevřeli administraci.

Bezpečný start díky testovacímu režimu

Po instalaci běží modul v testovacím režimu: platby stahuje a zobrazuje, ale objednávek se nedotýká a e-maily neposílá. V klidu si zkontrolujete, že se pohyby stahují a VS sedí, a teprve pak jedním přepínačem přejdete do ostrého provozu. Žádné riziko, že čerstvě nainstalovaný modul rozešle zákazníkům nečekané e-maily.

Plná automatizace přes CRON

Modul obsahuje CRON adresu chráněnou náhodným tokenem (kdykoli přegenerovatelným), připravený řádek do crontabu a tlačítko pro ruční spuštění. Doporučený interval je jednou za 5 minut – FIO API povoluje jeden dotaz za 30 sekund na token a modul má vestavěnou ochranu proti souběhu i příliš častému spouštění, takže limity banky nikdy nepřekročíte omylem.

Co modul dělá a nedělá – na rovinu

Modul pracuje výhradně s tokeny pro čtení: stahuje příchozí platby a mění stavy objednávek. Nikdy neprovádí odchozí platby ani refundace – to ostatně token pro sledování účtu ani neumožňuje. Přeplatky a nedoplatky vám označí a nechá na vašem rozhodnutí.

Kompatibilita a licence

• PrestaShop 1.7.6 – 9.x, PHP 7.1+ (PrestaShop 9 vyžaduje PHP 8.1+), podpora multistore
• Vyžaduje účet u Fio banky a API token (vytvoření v internetbankingu trvá minutu, návod je v dokumentaci modulu)
• Administrace česky a anglicky (kompletní překlad), e-maily v češtině a angličtině
• Licence vázaná na doménu e-shopu, časově neomezená – platíte jednou, žádné měsíční poplatky
• Aktualizace zdarma po sjednanou dobu; poté modul běží dál beze změny
• Offline aktivace licenčním kódem, bez závislosti na externích serverech

Časté dotazy

Funguje modul s více účty v různých měnách? Ano. Pro každý účet (CZK, EUR…) vygenerujete ve FIO internetbankingu vlastní token a přidáte ho do modulu. Počet účtů není omezen.

Co se stane, když zákazník zaplatí míň nebo víc? Modul platbu spáruje a objednávku přepne do stavu, který jste určili pro nedoplatek či přeplatek – klidně do interního stavu, který zákazník nevidí. Rozhodnutí, jak situaci vyřešit, zůstává na vás.

Musí mít zákazník při platbě správný variabilní symbol? Ideálně ano, ale když ho splete, opravíte ho v přehledu plateb na dvě kliknutí a modul objednávku ihned dopáruje. Objednávku lze přiřadit i ručně úplně bez VS.

Změní modul něco na účtu v bance? Ne. Používá token pouze pro čtení – z banky jen stahuje informace o příchozích platbách. Žádné odchozí operace neprovádí a technicky ani nemůže.

Jak často se platby stahují? Podle vašeho CRONu, doporučeně každých 5 minut. Modul hlídá limity FIO API, takže se banka nikdy nepřetíží.

Historie verzí

2.1.0 (červenec 2026)

• Kompletní anglický překlad administrace (194 textů) a jazykově závislé názvy stavů objednávek.
• Nový widget na úvodním dashboardu: stav modulu, čas poslední aktualizace s barevným semaforem, počty plateb za 24 hodin a 7 dní.
• Čas poslední aktualizace s barevným zvýrazněním i v přehledu plateb (červeně při stáří nad 24 hodin – hlídač CRONu).
• Položka menu přejmenována na „Příchozí platby z FIO"; aktualizace stávajících instalací bez ztráty dat.
• Srozumitelnější hlášky testovacího režimu s potvrzením přechodu do ostrého provozu.

2.0.0 (červen 2026)

• Kompatibilita s PrestaShopem 9 (nové překladové API, přepracovaná architektura konfigurace).
• Licenční aktivace: kód vázaný na doménu e-shopu, offline ověření; nastavení lze připravit před aktivací.
• Vynucení IPv4 pro komunikaci s FIO API (řeší známé visení spojení na dual-stack serverech).

1.2.0 (květen 2026)

• Tlačítko Test spojení u každého účtu s konkrétní diagnózou chyby (neplatný či prošlý token, omezení na IP, limit dotazů, SSL).
• Podrobné chybové hlášky FIO API místo obecného „spojení selhalo".
• Oprava posunu data transakce o den u plateb s časovou zónou.

1.0.0 (duben 2026)

• První vydání: více účtů a měn s maskovanými tokeny, párování dle VS (ID / reference / faktura s prefixem, hledání v poznámkách), mapa stavů, stavy pro nedoplatek a přeplatek, tolerance haléřů, blokované protiúčty, přehled plateb s opravou VS a ručním přiřazením, panel v detailu objednávky, e-mailové notifikace, testovací režim, CRON s tokenem, export do CSV, multistore.