Modul: CardPay pre PrestaShop / thirty bees

PrestaShop / thirty bees platobný modul CardPay pre platbu kreditnými kartami VISA, VISA Electron, MasterCard, Maestro alebo Diners Club. Podporuje platby Apple Pay. Službu prevádzkuje Tatra banka, a.s.. Spĺňa požiadavky SEPA v platnosti od 1.2.2014 a šifrovanie HMAC SHA256 (v platnosti od mája 2015).

Vlastnosti modulu

• kompatibilita: PrestaShop 1.4.x - 1.7.x
• podpora funkcie Multistore (viac obchodov)
• možnosť určiť spôsob objednávania
  • vytvorenie objednávky pred platbou (identifikátorom platby je číslo objednávky)
  • vytvorenie objednávky po zaplatení (identifikátorom platby je číslo nákupného košíka)
• možnosť určiť a párovať stavy objednávok, ktoré modul priraďuje objendávkam v závislosti od stavu platby priamo v administrácii modulu
• šifrovanie dát algoritmom:
  • HMAC SHA256 (v platnosti od mája 2015)
  • AES256 (v platnosti od februára 2014)
  • DES (zastarané)
• dodatočné overovanie podpisu verejným kľúčom Tatra banky
• spĺňa požiadavky SEPA v platnosti od 1.2.2014
• podporované typy kariet:
  • VISA
  • VISA Electron
  • MasterCard
  • Maestro
  • Diners Club International
• podpora platieb cez Apple Pay
• podpora platieb cez Google Pay
• dostupné platobné meny:
  • Euro
  • Americký dolár
  • Česká koruna
  • Anglická libra
  • Maďarský forint
  • Poľský zloty
  • Švajčiarský frank
  • Dánska koruna
• dostupné jazyky platobného rozhrania:
  • slovenský
  • český
  • anglický
  • poľský
  • maďarský
  • nemecký
  • španielský
  • francúzsky
  • talianský
• automatická implementácia ikony platobného systému a lôg akceptovaných bankových kariet vo verejnej časti Vášho obchodu
• automatická implementácia príslušných nových stavov objednávok a notifikačných e-mailových šablón do PrestaShop-u
• možnosť meniť pozíciu platobnej ikony z administrácie modulu (ľavý / pravý stĺpec, stránka detailu produktu)
• možnosť nastaviť odkaz cieľovej statickej (CMS) stránky z ikony CardPay
• možnosť vypnúť/zapnúť Material Design Icons
• dostupné preklady modulu: slovenský, český a anglický
• rýchla inštalácia
• jednoduché nastavenie

Kroky implementácie služby CardPay

1. Uzavrite s bankou zmluvu o prevádzkovaní služby pre už existujúci internetový obchod a obdržíte osobné číslo obchodníka a šifrovací kľúč.
2. Nainštalujte, nastavte a otestujte modul vo Vašom PrestaShop-e (pozrite si "Inštalácia a testovanie modulu").
3. Týmto je modul je pripravený k prevádzke.
4. Ak modul nepracuje správne, kontaktujte nás.

Informácie o službe CardPay

Všetky aktuálne obchodné podmienky o prevádzkovaní služby CardPay Vám poskytne Tatra banka.
Prejdite prosím na web Tatra banky: www.tatrabanka.sk

Inštalácia a testovanie modulu

1. Nahrajte priečinok "cardpay" do priečinku /modules/ prostredníctvom FTP, alebo použite nástroj pre nahrávanie modulov v časti Ovládací panel » Moduly » Pridať nový modul.
2. Vykonajte inštaláciu modulu v časti: Ovládací panel » Moduly
3. Prejdite k nastaveniam: Ovládací panel » Moduly » Platobné brány » Obmedzenia na základe meny, a vyberte voľbu "Predvolená mena v obchode".
4. Prejdite do nastavení modulu a zadajte údaje nasledovne:
   1. otvorte si v jednom okne prehliadača testovaciu stránku Tatra banky: moja.tatrabanka.sk
   2. skopírujte hodnoty ID obchodníka (MID) a Kľúč (KEY). V druhom okne prehliadača ich vložte a uložte ich do nastavenia modulu.
   3. voľbu "Zapnúť testovací režim" nastavte na hodnotu "áno"
   4. v treťom okne prehliadača prejdite do verejnej časti e-shopu a vložte do košíka tovar (ako bežný zákazník)
   5. v nákupnom košíku si z ponuky platobných brán si vyberte "CardPay"
   6. v ďalšom kroku sa Vám otvorí stránka obsahujúca červenou farbou zvýraznené údaje
   7. otvorte si opäť prvé okno prehliadača a nastavte testovací nástroj Tatra banky údajmi zobrazenými v predchádzajúcom kroku
   8. po vyplnení údajov stlačte tlačidlo "Overiť podpis"
   9. údaje vo Vašom e-shope sa musia zhodovať s údajmi vygenerovanými nástrojom Tatra banky, vrátane podpisu (angl. signature)
   10. v prípade, že sa podpisy nezhodujú, prekontrolujte všetky vstupné údaje. Ak ani opakovane nedosiahnete zhodu, kontaktujte prosím autora modulu.
   11. ak sa podpisy zhodujú, odporúčame urobit odtlačok obrazovky obsahujúci obe okná prehliadača súčasne (ktorý môžete zaslať pracovníkovi banky ako úspešný výsledok testu)
   12. prejdite do nastavenia modulu a:
       1. nastavte voľbu "Zapnúť testovací režim" nastavte na hodnotu "nie"
       2. vložte hodnoty "ID obchodníka" a "Šifrovací kľúč", ktoré Vám pridelila Tatra banka v zmluve
       3. ďalšie možnosti modulu nastavte podľa želania
5. Kontaktujte zamestnanca banky a oznámte mu dátum, od ktorého má banka na svojej strane systém CardPay pre Váš e-shop zapnúť. Prepošlite mu aj odtlačok obrazovky testu z bodu č.XI.
6. Týmto je modul pripravený pre prácu v ostrej prevádzke.
7. Pri inštalácii modulu došlo k automatickému umiestneniu ikony platobného systému v detaile produktu verejnej časti obchodu.
8. Pokiaľ by sa vyskytol problém, skontrolujte najskôr správnosť údajov vložených do nastavení modulu. Ak problém naďalej pretrváva, kontaktujte autora modulu.

Časté otázky pri prevádzke modulu

Pri platobnom procese sa zobrazí biela stránka. Prečo a ako problém odstrániť?
Odpoveď: Modul využíva pre generovanie bezpečnostného podpisu platby funkciu, ktorá je dostupná až vo verzii PHP 5.4 a vyššej. Váš obchod pravdepodobne beží na PHP serveri verzie 5.3 alebo nižšej. Aktualizujte prosím verziu PHP servera. Ak neviete o čo sa jedná, oslovte s požiadavkou poskytovateľa Vášho webhostingu.

Prečo sa, aj po otestovaní modulu na strane Tatra banky zobrazí informácia o vypršaní časového limitu?

Odpoveď: Po úspešnom otestovaní modulu, musí samotný bankový dom svoj systém pre Váš obchod zapnúť. Nie je to teda chyba modulu, ani dôvod na jeho reklamáciu, či vyžiadanie si pomoci. Je potrebné iba počkať, prípadne opakovane požiadať Tatra banku o zapnutie systému pre Váš e-shop.

V dizajne modulu CardPay vo verejnej časti obchodu sa mi zobrazuje pravý / ľavý stĺpec šablóny, aj keď sa pri iných platobných moduloch nezobrazuje. Kde a ako môžem nastaviť zobrazenie stĺpcov?
Odpoveď: Prejdite prosím do časti Ovládací panel > Predvoľby > Šablóny a logá (Back Office > Preferences > Themes), pri aktuálne zvolenej šablóne kliknite na tlačidlo "Upraviť". Následne sa dostanete do časti, kde môžete ovládať zobrazovanie stĺpcov pre rôzne stránky e-shopu. Pre modul CardPay nájdite položky "module-cardpay-payment" a "module-cardpay-validation" a nastavte zobrazovanie stĺpcov podľa Vášho želania.

TATRA BANKA CARDPAY MODULE - CHANGELOG

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.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