eCard VUB for PrestaShop (card payments module)

eCard VUB payment gateway allows customers to place payment using VISA, VISA Electron, MasterCard, Maestro, Diners Club and American Express debit/credit cards for your purchases in your store for the benefit of your Vseobecna uverova banka business account. This module provides an encrypted communication between your PrestaShop store and the VUB website - vub.sk.

Module features

• compatibility: PrestaShop 1.5.x - 1.7.x
• Multistore (Multiple shops) feature supported
• quick module installation
• easy module setup
• supported card types:
  • VISA
  • VISA Electron
  • MasterCard
  • Maestro
  • Diners Club
  • American Express
• supported currencies:
  • Euro
  • US Dollar
  • Czech koruna
  • Hungarian Forint
  • Polish Zloty
• available eCard VUB interface languages:
  • English
  • Slovak
• security is provided by:
  • using 3-D Secure technology
• module translations available: English, Slovak and Czech
• automatic payment icon and card logos implementation into PrestaShop Front Office
• payment icon position control via module administration (left / right column, product detail page)
• the ability to set a target CMS page from eCard VUB icon
• the ability to set a custom order statuses for successful and an unsuccessful payment

eCard VUB service implementation steps

1. Sign contract with VUB bank for your e-commerce.
2. Install, setup and test the eCard VUB module in your PrestaShop (see "Module installation and testing").
3. Test the module - VUB providing testing credit cards for you.
4. After this action is module ready to work in live environment.
5. If any problem occurred, please contact module author.

eCard VUB service information

All current terms and conditions for eCard VUB service will give you Vseobecna uverova banka, Inc..
Please, go to Vseobecna uverova banka website: www.vub.sk

Module installation and testing

1. Upload folder "ecardvub" 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 check the currency that you signed in the contract.
4. Go into module settings and fill data provided by VUB:
   • Merchant ID
   • 3D security key
5. Set "Working mode" option to "testing".
6. Contact the bank employee and make the module testing.
7. When testing will be successful set "Working mode" option to "live" and module is ready to work in live environment.
8. While module installation the payment icon has been placed into product detail page of your eshop Front Office.
9. If any problem occurred, check your settings data filled into module first. If problem still persist, contact module author.

Payment log

Module using "[PREFIX] _ecardvub_log" database table for storing the records about eCard VUB payments in your PrestaShop (no sensitive customer or card data). This table stay untouched if the module will be uninstall or removed.

Record listing is available in the eCard VUB module back office.

Frequently asked questions (FAQ)

I'd like to hide left / right column in eCard VUB 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-ecardvub-payment" and "module-ecardvub-validation" records for eCard VUB module and adjust displaying columns for your wish.

ECARD VUB MODULE - CHANGELOG

version 1.7.9 (10/31/2020)
    x added update for PSD2

version 1.7.8 (04/12/2020)
    x fixed bug with redirecting from the checkout

version 1.7.7 (01/03/2020)
    + added Back Office CSS and JavaScript file (displayBackOfficeHeader hook)
    - removed useless payment step - the customer is redirected on the payment gateway directly from the checkout page
    x IMPORTANT FIX: changed the way how to handle $required parameter in the response to verify the transaction signature
    x IMPORTANT FIX: removed MD parameter from the validation process in the response (reason: response after Diners Club card payment doesn't contain MD parameter)
    x payment icons redesign
    x improved module back office - added an icons and buttons
    x fixed displaying "tax included" suffix (and his translation) depending on PrestaShop tax settings
    x updated available card payments allowed by eCard VUB 
    x improved selector to choose the type of goods you selling
    x updated module documentation

version 1.7.6 (10/25/2019)
    + added selector for PrestaShop theme
    + added private notes field
    + added selector to choose the type of goods you selling
    + added a price comparison on order to prevent change the order by customer while is payment processed
    x fixed missing order_status variable when error message
    x updated available card payments allowed by eCard VUB 
    x updated module documentation

version 1.7.5 (03/20/2019)
    + added a new supported currencies and languages

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

version 1.7.3 (11/13/2018)
    x IMPORTANT UPDATE: a new response processing from payment gateway based on statuses: Approved, Declined and Error instead MD status.
    + added logging response URL 
    + added module upgrade script - added a new columns into MySQL tables: response_file, order_method & return_url
    x changed MySQL table parameters
    + added DB logging for "Order before payment" method
    + added a new payment state "Declined eCard VUB payment"
    + added a new columns into record table in order to easiest identify payment errors
    x improved notification messages
    x fixed missing $cart definition in hookPaymentReturn (thanks to Mr. Majzlik)

version 1.7.2 (11/30/2017)
    x updating testing payment URL
    x fixed translation of the order private message created by the module
    x improved adding order Private messages

version 1.7.1 (11/10/2017)
    x fixed payment validation process for PrestaShop 1.7.2.x

version 1.7.0 (15/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
    x updated module documentation
    x updated "Terms and conditions of use" document

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

version 1.6.9 (12/17/2019)
    x IMPORTANT FIX: changed the way how to handle $required parameter in the response to verify the transaction signature
    x IMPORTANT FIX: removed MD parameter from the validation process in the response (reason: response after Diners Club card payment doesn't contain MD parameter)
    + added private notes field
    x improved selector to choose the type of goods you selling
    x payment icons redesign

version 1.6.8 (07/03/2019)
    + added a new supported currencies and languages
    + added selector to choose the type of goods you selling
    + added a price comparison on order to prevent change the order by customer while is payment processed
    x updated module documentation
    x fixed missing order_status variable when error message
    x updated available card payments allowed by eCard VUB 

version 1.6.7 (11/13/2018)
    x IMPORTANT UPDATE: a new response processing from payment gateway based on statuses: Approved, Declined and Error instead MD status.
    + added a new payment state "Declined eCard VUB payment"
    + added a new columns into record table in order to easiest identify payment errors
    x improved notification messages

version 1.6.6 (10/02/2018)
    x fixed & improved response process
    + added logging response URL 
    + added module upgrade script - added a new columns into MySQL tables: response_file, order_method & return_url
    x changed MySQL table parameters
    + added DB logging for "Order before payment" method

version 1.6.5 (07/10/2018)
    x fixed missing $cart definition in hookPaymentReturn (thanks to Mr. Majzlik)

version 1.6.4 (11/30/2017)
    x updating testing payment URL
    x fixed translation of the order private message created by the module
    x improved adding order Private messages

version 1.6.3 (02/12/2017)
    + added dual payment method: Order method selector (creating an order before or after the payment)
    + added a new payment state "Awaiting eCard VUB payment"
    + added Order payment state selectors to freedom in pairing module statuses with PrestaShop built-in order statuses
    x updated module documentation

version 1.6.2 (12/31/2016)
    + added compatibility with "Advanced EU Compliance" module
    x improved copying module email templates & new order status creation    
    x improved notification system
    x updated "Terms and conditions of use" document

version 1.6.1 (12/08/2016)
    + added Order payment state selectors
    + added and display payment records in the module
    + added responsive feature for image icons
    x moved "img" and "css" folder into "views" folder
    x updated module documentation
    x fixed displaying "Repeat the payment" button on notification page

version 1.6.0 (08/01/2016)
    + initial release for PrestaShop 1.6.x & 1.5.x

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

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