TatraPay for PrestaShop (payment gateway)

TatraPay service allows customers to make non-cash payment for purchases in your store for the benefit of your Tatra banka account. This module provides an encrypted communication between your PrestaShop store and the Tatra banka website - tatrabanka.sk.

Module features

• compatibility: PrestaShop 1.4.x - 1.7.x
• Multistore (Multiple shops) feature supported
• AES256 or DES (deprecated) data encryption
• data encryption algorithms available:
  • HMAC SHA256 (used since 05/2015)
  • AES256 (used since 02/2014)
  • DES (deprecated)
• additional signature verification by Tatra banka public key
• fulfills the requirements of SEPA since 02/01/2014
• available payment currencies: Euro
• available payment interface languages: English and Slovak
• quick module installation
• easy module setup
• automatic payment icon implementation into Front Office
• payment icon position control via module administration (left / right column, product detail page)
• ability to set a target CMS page from TatraPay icon
• module languages available: English, Slovak and Czech

TatraPay service implementation steps

1. Sign contract with Tatra banka, a.s. and get Merchant ID and Encryption Key for your e-commerce.
2. Install, setup and test the TatraPay module in your PrestaShop (see "Module installation and testing").
3. After this action is module ready to work in live environment.
4. If any problem occurred, please contact module author.

TatraPay service information

All current terms and conditions for TatraPay service will give you Tatra banka.
Please, go to Tatra banka website: www.tatrabanka.sk

Module installation and testing

1. Upload folder "tatrapay" into /modules/ folder via FTP or use module upload tool in Back Office » Modules to upload module package.
2. Install module in: Back Office » Modules
3. Go into settings: Back Office » Payment » Payment modules list, and chceck the option "Shop default currency".
4. Go into module settings and fill data following way:
   1. open Tatra bank testing tool in first browser window: moja.tatrabanka.sk
   2. copy values fo Merchant ID (MID) and Key (KEY). Fill and save these values in module settings in the second browser window.
   3. set "Allow Testing mode" option to "yes"
   4. go into Front Office in the third browser window and put any product in the cart (like customer)
   5. chose "TatraPay" payment method in the shopping cart
   6. in the next step you will see red colored data
   7. open first browser window again and setup Tatra bank Testing tool with data displayes in previous step
   8. click on "Verify signature" button
   9. all data in your eshop must match with data on testing tool, including signature
   10. if signatures not match, check all input data. Contact module author, when problem still persist.
   11. if signatures match, make the screenshot both browser windows together (you can send screenshot to bank employye as module testing result)
   12. go into module settings and:
       1. switch "Allow Testing mode" option to "no"
       2. fill "Merchan ID" and "Encryption Key" with data you received from Tatra banka
       3. setup rest of module options as you wish
5. Contact the bank employee and specify the date from which you want start using TatraPay payments on your eshop. Send him screenshot with module testing result.
6. After this action will be module ready to work in live environment.
7. While module installation the payment icon has been placed into product detail page of your eshop Front Office.
8. If any problem occurred, check your settings data filled into module first. If problem still persist, contact module author.

Frequently asked questions (FAQ)

In the payment process I see blank page. Why and how to fix it?
Answer: Module using a function available in PHP 5.4+ in order to generate payment security sign. Your store running on PHP server 5.3 or less. Please update your PHP server on 5.4+ or ask your webhosting provider with this request.

Why after module testing on Tatra banka website still "Timeout" message appear?

Answer: After successful module testing, the bank house must allow the payments (on their side) for your eshop. Please wait awhile (hours or days). If "Timeout" message still appear, please contact bank employee again and urgent to allow payments for your eshop.

I'd like to hide left / right column in TatraPay module pages for Front office. Where and how can I adjust it?
Answer: Go into Back Office > Preferences > Themes, and click "Edit" button for current theme. Now you allowed to change displaying the columns for various store pages. Find "module-tatrapay-payment" and "module-tatrapay-validation" records for TatraPay module and adjust displaying columns for your wish.

TATRA BANKA TATRAPAY MODULE - CHANGELOG

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