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

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

version 1.7.12 (05/19/2022)
    x added BO module tabs for better UX usability and experience
    + added feature in order to add custom & multi-language name of the payment method in the checkout
    + added an option to show/hide detailed payment instructions in the checkout
    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.11 (12/25/2021)
    + added an option to choose payment variable symbol type (Order ID or Order reference)
    + added order payment record if payment state has logable option allowed
    + added INVOICENUMBER parameter into transaction
    + added separated Merchant ID and Security Key fields for testing and live environment

version 1.7.10 (09/29/2021)
    + 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 detail 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 Apple Pay & Google Pay logo
    + added explanation instruction for customers on the Checkout
    + added an PHP warning alert
    + added a custom hook {hook h='displayecardvubicons'} in order to display module payment icons everywhere you want
    + added Back Office CSS file (displayBackOfficeHeader hook)
    + added an option to redirect customer back into checkout when the payment was not successful (for "place an order after the payment" order method)
    + added log file for debugging purposes to recording: request payment info/URL, return payment info/URL, transaction notification
    + added "repeat" controller in order to fix conflict with "payment" controller and PS_PURCHASE_MINIMUM value when calling repeat the payment
    + get Time zone setting for payment from PrestaShop localization settings

    - removed useless payment step - the customer is redirected on payment gateway directly from the checkout page
    - removed module JS file that may affected PrestaShop BO

    x fixed Repeat payment bug with redirection when minimal purchase is no zero
    x fixed parameters in {guest_tracking_url} template email URL
    x improved return URL when guest/customer cancel the order by his choice
    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 fixed order data in notification controller
    x fixed payment return referral URL for log
    x updated VISA a VISA Electron logo, 2021 version
    x various code improvements
    x updated module documentation

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


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

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