TatraPay pro PrestaShop (platební modul)

Služba TatraPay umožňuje zákazníkům bezhotovostní platbu za zakoupené zboží ve Vašem e-shopu ve prospěch Vašeho bankovního účtu vedeného v Tatra bance. Modul zabezpečuje šifrovanou komunikaci mezi Vaším internetovým obchodem PrestaShop a webem Tatra banky - tatrabanka.sk.

Vlastnosti modulu

• kompatibilita: PrestaShop 1.5.x - 8.x
  
• podpora funkce Multistore (více obchodů)
• šifrování dat algoritmem:
  • HMAC SHA256 (v platnosti od května 2015)
  • AES256 (v platnosti od února 2014)
  • DES (zastaralé)
• dodatečné ověřování podpisu veřejným klíčem Tatra banky
• splňuje požadavky SEPA v platnosti od 1.2.2014
• dostupné platební měny: Euro
• dostupné jazyky platebního rozhraní: slovensk a anglický
• rychlá instalace
• snadné nastavení
• automatická implementace ikony platebního systému a log akceptovaných bankovních karet ve veřejné části Vašeho obchodu
• možnost měnit pozici platební ikony z administrace modulu (levý / pravý sloupec, stránka detailu produktu)
• dostupné jazyky: český, slovenský a anglický

Kroky implementace služby TatraPay

1. Uzavřete s bankou smlouvu o provozování služby pro již existující internetový obchod a obdržíte osobní číslo obchodníka a šifrovací klíč
2. Nainstalujte, nastavte a otestujte modul ve Vašem PrestaShop-u (viz. "Instalace a testování modulu").
3. Tímto je modul je připraven k provozu.
4. Pokud modul nepracuje správně, kontaktujte nás.

Informace o službě TatraPay

Všechny aktuální obchodní podmínky o provozování služeb TatraPay Vám poskytne Tatra banka.
Přejděte prosím na web Tatra banky: www.tatrabanka.sk

Instalace a testování modulu

1. Nahrajte složku "tatrapay" do složky /modules/ prostřednictvím FTP, nebo použijte nástroj pro nahrávání modulů v části Kontrolní panel » Moduly » Přidat nový modul.
2. Proveďte instalaci modulu v části: Kontrolní panel » Moduly
3. Přejděte k nastavením: Kontrolní panel » Moduly » Platební brány » Omezení na základě měny, a vyberte volbu "Výchozí měna v obchodě".
4. Přejděte do nastavení modulu a zadejte údaje následovně:
   1. otevřete si v jednom okně prohlížeče testovací stránku Tatra banky: moja.tatrabanka.sk
   2. zkopírujte hodnoty ID obchodníka (MID) a Klíč (KEY). V druhém okně prohlížeče je vložte a uložte je do nastavení modulu.
   3. volbu "Zapnout testovací režim" nastavte na hodnotu "ano"
   4. ve třetím okně prohlížeče přejděte do veřejné části e-shopu a vložte do košíku zboží (jako běžný zákazník)
   5. v nákupním košíku si z nabídky platebních bran si vyberte "TatraPay"
   6. v dalším kroku se Vám otevře stránka obsahující červenou barvou zvýrazněné údaje
   7. otevřete si opět první okno prohlížeče a nastavte testovací nástroj Tatra banky údaji zobrazenými v předchozím kroku
   8. po vyplnění údajů stiskněte tlačítko "Ověřit podpis"
   9. údaje ve Vašem e-shopu se musí shodovat s údaji vygenerovanými nástrojem Tatra banky, včetně podpisu (angl. signature)
   10. v případě, že se podpisy neshodují, překontrolujte všechny vstupní údaje. Pokud ani opakovaně nedosáhnete shodu, kontaktujte prosím autora modulu.
   11. pokud se podpisy shodují, doporučujeme udelat otisk obrazovky obsahující obě okna prohlížeče současně (který můžete zaslat pracovníkovi banky jako úspěšný výsledek testu)
   12. přejděte do nastavení modulu a:
       1. nastavte volbu "Zapnout testovací režim" nastavte na hodnotu "ne"
       2. vložte hodnoty "ID obchodníka" a "Šifrovací klíč", které Vám přidělila Tatra banka ve smlouvě
       3. další možnosti modulu nastavte podle přání
5. Kontaktujte zaměstnance banky a oznamte mu datum, od kterého má banka na své straně systém TatraPay pro Váš e-shop zapnout. Přepošlete mu i otisk obrazovky testu z bodu č.XI.
6. Tímto je modul připraven pro práci v ostrém provozu.
7. Při instalaci modulu došlo k automatickému umístění ikony platebního systému v detailu produktu veřejné části obchodu.
8. Pokud by se vyskytl problém, zkontrolujte nejdříve správnost údajů vložených do nastavení modulu. Pokud problém přetrvává, kontaktujte autora modulu.

Časté dotazy při provozu modulu

Při platebním procesu se zobrazí stránka bílá. Proč a jak problém odstranit?
Odpověď: Modul využívá pro generování bezpečnostního podpisu platby funkci, která je dostupná až ve verzi PHP 5.4 a vyšší. Váš obchod pravděpodobně běží na PHP serveru verze 5.3 nebo nižší. Aktualizujte prosím verzi PHP serveru. Pokud nevíte o co se jedná, oslovte s požadavkem poskytovatele Vašeho webhostingu.

Proč se, i po otestování modulu na straně Tatra banky zobrazí informace o vypršení časového limitu?

Odpověď: Po úspěšném otestování modulu, musí samotný bankovní dům svůj systém pro Váš obchod zapnout. Není to tedy chyba modulu, ani důvod k jeho reklamaci, zda vyžádání si pomoci. Je třeba pouze počkat, případně opakovaně požádat Tatra banku o zapnutí systému pro Váš e-shop.

V designu modulu TatraPay ve veřejné části obchodu se mi zobrazuje pravý / levý sloupec šablony, i když se při jiných platebních modulech nezobrazuje. Kde a jak mohu nastavit zobrazení sloupců?
Odpověď: Přejděte prosím do části Kontrolní panel > Předvolby > Šablony a loga (Back Office > Preferences > Themes), při aktuálně zvolené šabloně klikněte na tlačítko "Upravit". Následně se dostanete do části, kde můžete ovládat zobrazování sloupců pro různé stránky e-shopu. Pro modul TatraPay najděte položky "module-tatrapay-payment" a "module-tatrapay-validation" a nastavte zobrazování sloupců dle Vašeho přání.

TATRA BANKA TATRAPAY MODULE - CHANGELOG

version 1.7.4 (02/18/2022)
    x improved transaction validation

version 1.7.3 (09/04/2020)
    + added upgrade script
    + added Back Office CSS and JavaScript file (displayBackOfficeHeader hook)
    + added Type goods selector
    + added selector for PrestaShop theme (on/off Material Design Icons)
    + added private notes field
    x payment icons redesign
    x fixed displaying "tax included" suffix (and his translation) for the price based on PrestaShop tax settings
    x fixed "tax incl." string translation
    - removed useless payment step for both types of payment methods - the customer is redirected on the payment gateway directly from the checkout page

version 1.7.2 (06/05/2019)
    x fixed PHP notice for order private messages variable
    x extended _addNewPrivateMessage function

version 1.7.1 (12/03/2017)
    x fixed payment validation process for PrestaShop 1.7.2.x
    x fixed translation of the order private message created by the module

version 1.7.0 (02/13/2017)
    + initial release for PrestaShop 1.7.x (testing environment: PrestaShop 1.7.0.4)
    + front office redesign for PrestaShop 1.7 Classic theme
    + added Order payment status selectors
    x improved testing mode
    x fixed currency check function
    x updated module documentation
    x updated "Terms and conditions of use" document

----------------- PrestaShop 1.7.x -----------------

version 1.6.7 (01/28/2017)
    + added dual payment method: Order method selector (creating an order before or after the payment)
    + added new payment statuses "Awaiting CardPay payment" and "Awaiting TatraPay payment verification"
    + added Order payment status selectors to freedom in pairing module statuses with PrestaShop built-in order statuses
    x moved validation script into "response" folder
    x moved "img" and "css" folder into "views" folder
    x fixed currency check function
    x updated module documentation
    x updated "Terms and conditions of use" document
    x improved the module code

version 1.6.6 (12/30/2016)
    + added compatibility with "Advanced EU Compliance" module
    x changed TatraPay logotype
    + added responsive feature for image icons
    x minor code changes

version 1.6.5 (01/19/2017)
    x minor changes
    x changed "Signature (HMAC)" into "HMAC" in testing mode (Tatra banka request)

version 1.6.4 (09/01/2015)
    x updated release - Merchant Integration Manual; version: 4.0 used
    x changed payment URL
    x updated documentation
    + module now using HMAC SHA256 encoding type only
    + added CMS page selector for icon destination link
    
version 1.6.3 (05/25/2015)
    + added product detail icon position and set as default
    + added PHP version warning alert
    + added PHP comparator for different sign generator process
    x improved & unificated CSS to better working with 1.6.x themes
    x improved & fixed notification system
    x updated & unificated documentation

version 1.6.2 (09/14/2014)
    + added module version info into module setting page
    + added encoding type selector (AES256 and DES)
    + added automatic customer language detection
    x added SS parameter into return process
    x changed payment return process
    x improved module Documentation

version 1.6.1 (04/19/2014)
    + module compatibility for PrestaShop 1.6.x
    + new module versioning containing a PrestaShop version
    x redesign module Back office for PrestaShop 1.6.x
    x updated and improved module Documentation
    x changed "Waiting payment" order status color
    x redesign e-mail notification templates, including responsive feature
    - removed useless Working mode selector

----------------- PrestaShop 1.6.x -----------------

version 1.5 (02/21/2014)
    x updated MID parameter from 8 bit to 32 bit due SEPA instructions
    x replaced DES signature encoding to AES256 encoding

version 1.4 (07/26/2013)
    + added full English and Slovak documentation

version 1.3 (07/03/2013)
    x rewriting validation payment process; removed deprecated code

version 1.2 (06/17/2013)
    + added e-mail templates auto-copy function [installation module]
    + added tatrapay.css to design front-end pages

version 1.1 (05/14/2013)
    + Payment URL correction

version 1.0 (09/23/2012)
    + initial release for PrestaShop 1.5.x

----------------- PrestaShop 1.5.x -----------------

---------------------

Legend:
    + added a new feature
    x fixed issue, updated feature
    - removed feature