CardPay pro PrestaShop (platební modul)

Služba CardPay umožňuje zákazníkům bezhotovostní platbu debetními a kreditními kartami VISA, VISA Electron, MasterCard, Maestro a Diners Club 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.4.x - 1.7.x
• podpora funkce Multistore (více obchodů)
• podpora plateb Apple Pay
• podpora plateb Google Pay
• šifrování dat algoritmem:
  • HMAC SHA256 (v platnosti od května 2015)
  • AES256 (v platnosti od února 2014)
  • DES (zastaralé)
• splňuje požadavky SEPA v platnosti od 1.2.2014
• dostupné platební měny: Euro, Americký dolar, Česká koruna, Anglická libra, Maďarský forint, Polský zlotý, švýcarský frank, Dánská koruna
• dostupné jazyky platebního rozhraní: český, slovenský, polský, maďarský, německý, anglický, španělský, francouzský a italský
• 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)
• dostupné jazyky: český, slovenský a anglický

Kroky implementace služby CardPay

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ě CardPay

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

Instalace a testování modulu

1. Nahrajte složku "CardPay" 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 "CardPay"
   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 CardPay 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 CardPay 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 CardPay najděte položky "module-cardpay-payment" a "module-cardpay-validation" a nastavte zobrazování sloupců dle Vašeho přání.

TATRA BANKA CARDPAY MODULE - CHANGELOG

version 1.7.11 (05/25/2022)
    x added BO module tabs for better UX usability and experience

version 1.7.10 (05/09/2022)
    + added feature in order to add custom & multi-language name of the payment method in the checkout
    + added an option to choose value of the E2E parameter
    + added SQL table PREFIX_cardpay_log installation (for future features only)
    x extended payment private message for "place an order after the payment" order method
    x fixed bug when payment response not accepted VS = order reference
    x do not display module alerts when the module is no active
    x fixed missing nbProducts variable into notification page
    x normalized Hook names

version 1.7.9 (01/24/2022)
    + added an option to choose payment variable symbol type (Order ID or Order reference)
    + added displayAdminOrderMainBottom hook
    + added information & action panel about card transaction in the back-office order detail 
    + added order payment record if payment state has logable option allowed
    x fixed input variables (customer's shipping address) for signature
    x fixed missing SK & CZ translations

version 1.7.8 (10/19/2021)
    x added multi-currency support
    + added displayOrderDetail hook
    + added "Finish payment" button - the customer is now allowed to pay later from an Order detail / Guest tracking page
    + added "Cancel payment & order" button - the customer is now allowed to cancel the payment and order
    + added an option to redirect customer when the payment was not successful: 
       + for "place an order before the payment" order method - redirect into order detial page with "Finish payment" button
       + for "place an order after the payment" order method - redirect back into checkout
    + added variables for adding a marketing & affiliate codes
    + added an warning alert when friendly URLs are disabled and SSL is not available
    + added changing order state when customer cancel the payment (for "place an order before the payment" order method)
    + added Extra email variables
    + added "modern" e-mail templates + TWIG template for generate HTML templates
    + added log file to recording payment transactions for debugging purposes
    + added "repeat" controller in order to fix conflict with "payment" controller and PS_PURCHASE_MINIMUM value when calling repeat the payment

    - removed useless payment step - the customer is redirected on payment gateway directly from the checkout page

    x fixed parameters in {guest_tracking_url} template email URL
    x fixed an issue when friendly URLs were disabled 
    x revamped whole payment and redirection process
    x improved payment intro page in the checkout - added information about payment process
    x simplified of the payment execution template
    x updated notification email templates - added "Finish Payment" button
    x updated VISA and VISA Electron logo, 2021 version
    x improved module code
    x updated module documentation

version 1.7.7 (05/17/2021)
    + added an option to redirect customer back into checkout when the payment was not successful (for "place an order after the payment" order method)
    x fixed a special characters in the customer address

version 1.7.6 (03/09/2021)
    IMPORTANT UPDATE: 
    x updated release - Merchant Integration Manual; version: 2.0 used
    x fixed little typo in the function converting name of the customer
    x fixed calculating SIGN for testing environment
    + added an warning alert when friendly URLs are disabled
    + added a custom hook {hook h='displaycardpayicons'} in order to display module payment icons everywhere you want
    - removed module JS file that affected PrestaShop BO

version 1.7.5 (09/04/2020)
    - removed useless payment step for both types of payment methods
    + added Google Pay logo
    x updated module documentation

version 1.7.4 (01/03/2020)
    + added Back Office CSS and JavaScript file (displayBackOfficeHeader hook)
    + added Type goods selector
    - removed useless payment step - the customer is redirected on the payment gateway directly from the checkout page
    x payment icons redesign
    x added Apple Pay logo
    x fixed displaying "tax included" suffix (and his translation) for the price based on PrestaShop tax settings
    x updated module documentation

version 1.7.3 (11/12/2019)
    x updated release - Merchant Integration Manual; version: 1.8 used
    x fixed signature comparison in validation process by adding a new RC variable
    x fixed "tax incl." string translation
    + added selector for PrestaShop theme (on/off Material Design Icons)
    + added ECDSA verification
    + added private notes field

version 1.7.2 (11/21/2018)
    x added a price comparison on order to prevent change the order by customer while is payment processed

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 (13/02/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
    + added editable source file for card payment logos
    x moved validation script into "response" folder
    x fixed TPAY parameter
    x improved testing mode
    x fixed currency check function
    x updated card payment logos
    x updated module documentation
    x updated "Terms and conditions of use" document

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

version 1.6.18 (05/09/2022)
    + added feature in order to add custom & multi-language name of the payment method in the checkout
    + added an option to choose value of the E2E parameter
    + added SQL table PREFIX_cardpay_log installation (for future features only)
    x extended payment private message for "place an order after the payment" order method
    x fixed bug when payment response not accepted VS = order reference
    x do not display module alerts when the module is no active
    x fixed missing nbProducts variable into notification page
    x normalized Hook names

version 1.6.17 (12/25/2021)
    + added an option to choose payment variable symbol type (Order ID or Order reference)
    + added multi-currency support
    + added displayAdminOrder hook
    + added displayOrderDetail hook
    + added order payment record if payment state has logable option allowed
    + added "Finish payment" button - the customer is now allowed to pay later from an Order detail / Guest tracking page
    + added "Cancel payment & order" button - the customer is now allowed to cancel the payment and order
    + added an option to redirect customer when the payment was not successful: 
       + for "place an order before the payment" order method - redirect into order detial page with "Finish payment" button
       + for "place an order after the payment" order method - redirect back into checkout
    + added variables for adding a marketing & affiliate codes
    + added an warning alert when friendly URLs are disabled and SSL is not available
    + added changing order state when customer cancel the payment (for "place an order before the payment" order method)
    + added Extra email variables
    + added log file to recording payment transactions for debugging purposes
    + added "repeat" controller in order to fix conflict with "payment" controller and PS_PURCHASE_MINIMUM value when calling repeat the payment

    - removed useless payment step - the customer is redirected on payment gateway directly from the checkout page

    x fixed input variables (customer's shipping address) for signature
    x fixed parameters in {guest_tracking_url} template email URL
    x fixed an issue when friendly URLs were disabled 
    x revamped whole payment and redirection process
    x improved payment intro page in the checkout - added information about payment process
    x simplified of the payment execution template
    x updated notification email templates - added "Finish Payment" button
    x updated VISA and VISA Electron logo, 2021 version
    x improved module code
    x updated module documentation

version 1.6.16 (04/26/2021)
    + added an option to redirect customer back into checkout when the payment was not successful (for "place an order after the payment" order method)

version 1.6.15 (03/09/2021)
    IMPORTANT UPDATE: 
    x fixed little typo in the function converting name of the customer
    x fixed calculating SIGN for testing environment
    + added a custom hook {hook h='displaycardpayicons'} in order to display module payment icons everywhere you want
    - removed module JS file that affected PrestaShop BO

version 1.6.14 (01/23/2021)
    x fixed card logo link in the cart
    - removed useless code

version 1.6.14 (12/27/2020)
    x IMPORTANT UPDATE: 
    x updated release - Merchant Integration Manual; version: 2.0 used
    + added Back Office CSS and JavaScript file (displayBackOfficeHeader hook)
    + added Type goods selector
    + added selector for PrestaShop theme (on/off Material Design Icons)
    + added an warning alert when friendly URLs are disabled
    x payment icons redesign
    x added Apple Pay and Google Pay logo
    x fixed displaying "tax included" suffix (and his translation) for the price based on PrestaShop tax settings
    x updated module documentation
    x fixed little typo in the function converting name of the customer

version 1.6.13 (11/12/2019)
    x updated release - Merchant Integration Manual; version: 1.8 used
    x fixed signature comparison in validation process by adding a new RC variable
    + added ECDSA verification
    + added private notes field

version 1.6.12 (11/21/2018)
    x added a price comparison on order to prevent change the order by customer while is payment processed

version 1.6.11 (12/05/2017)
    x revert Name clean function
    x updated module documentation
    x fixed translation of the order private message created by the module

version 1.6.10 (05/29/2017)
    x improved Name clean function

version 1.6.9 (03/16/2017)
    - removed CID parameter

version 1.6.8 (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"
    + 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.7 (12/30/2016)
    + added compatibility with "Advanced EU Compliance" module
    x changed CardPay logotype (requested by Tatra banka)
    x minor code changes

version 1.6.6 (11/02/2016)
    x fixed TPAY parameter
    + added responsive feature for image icons

version 1.6.5 (01/19/2016)
    x minor changes

version 1.6.4 (09/01/2015)
    x updated release - Merchant Integration Manual; version: 4.0 used
    x changed payment URL
    x fixed bug with processing of variables in validation process
    x fixed UTC timestamp
    x updated documentation
    + module now using HMAC SHA256 encoding type only
    + add TPAY, TIMESTAMP and CID parameter
    + added CMS page selector for icon destination link
    - removed fields: Mobile phone; Payment description

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 encoding type selector (AES256 and DES)
    + added module version info into module setting page
    + added automatic customer language detection
    + added more available interface languages: English, German, Spanish, French, Italian, Slovak, Czech, Polish and Hungarian
    + added more available payment currencies: US Dollar, Czech Koruna, British Pound, Hungarian Forint, Polish Zloty, Swiss Franc, Danish krone
    + added MOBILE_DEVICE variable
    x updated module Documentation
    - removed CS parameter
    
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
    - removed useless Working mode selector

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

version 1.5.4 (01/28/2017)
    + module now using HMAC SHA256 encoding type only
    + added dual payment method: Order method selector (creating an order before or after the payment)
    + added new payment statuses "Awaiting CardPay payment"
    + added Order payment status selectors to freedom in pairing module statuses with PrestaShop built-in order statuses
    + add TPAY, TIMESTAMP and CID parameter
    + added CMS page selector for icon destination link
    + added compatibility with "Advanced EU Compliance" module
    + added product detail icon position and set as default
    + added PHP version warning alert
    + added PHP comparator for different sign generator process
    + added responsive feature for image icons
    + added module version info into module setting page
    + added automatic customer language detection
    + added more available interface languages: English, German, Spanish, French, Italian, Slovak, Czech, Polish and Hungarian
    + added more available payment currencies: US Dollar, Czech Koruna, British Pound, Hungarian Forint, Polish Zloty, Swiss Franc, Danish krone
    + added MOBILE_DEVICE variable
    - removed fields: Mobile phone; Payment description
    - removed CS parameter
    - removed useless Working mode selector
    x moved validation script into "response" folder
    x moved "img" and "css" folder into "views" folder
    x fixed currency check function
    x updated "Terms and conditions of use" document
    x improved the module code
    x changed CardPay logotype (requested by Tatra banka)
    x minor code changes
    x fixed TPAY parameter
    x minor changes
    x updated release - Merchant Integration Manual; version: 4.0 used
    x changed payment URL
    x fixed bug with processing of variables in validation process
    x fixed UTC timestamp
    x improved & unificated CSS to better working with 1.6.x themes
    x improved & fixed notification system
    x updated and improved module Documentation

version 1.5.3 (18/01/2016)
    x fixed UTC timestamp
    x fixed bug with processing of variables in validation process

version 1.5.2 (08/22/2015)
    x fixed UTC timestamp

version 1.5.2 (08/13/2015)
    x updated release - Merchant Integration Manual; version: 4.0 used
    x changed payment URL
    + add TPAY, TIMESTAMP and CID parameter
    + added HMAC encoding type
    - removed fields: Mobile phone; Payment description

version 1.5.1 (09/14/2014)
    + new module versioning containing a PrestaShop version
    + added encoding type selector (AES256 and DES)
    + added module version info into module setting page
    + added automatic customer language detection
    + added more available interface languages: English, German, Spanish, French, Italian, Slovak, Czech, Polish and Hungarian
    + added more available payment currencies: US Dollar, Czech Koruna, British Pound, Hungarian Forint, Polish Zloty, Swiss Franc, Danish krone
    + added MOBILE_DEVICE variable
    x added SS parameter into return process
    x changed payment return process
    x updated module Documentation
    - removed CS parameter

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

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

version 1.1.0 (06/17/2013)
    + added cardpay.css to design front-end pages
    x payment icon fix
    x small design improvements

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

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

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