ePlatby VÚB for PrestaShop (payment gateway)

ePlatby VUB service allows customers to make non-cash payment for purchases in your store for the benefit of your VUB bank account. This module provides an encrypted communication between your PrestaShop store and the VUB bank website - vub.sk.

Module features

• compatibility: PrestaShop 1.4.x - 1.7.x
  
• Multistore (Multiple shops) feature supported
• 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)
• languages available: Slovak, English

Module installation

1. Open "eplatbyvub.php" module file in favorite edit app and at the line #43 you'll find:
   $this->sifrovaci_kluc = 'SEM-VLOZTE-VAS-64-ZNAKOVY-KLUC-OD-VUB';
   Between quotation marks put secret key you provided by VUB bank.
2. Upload folder "eplatbyvub" into /modules/ folder via FTP or use module upload tool in Back Office » Modules to upload module package.
3. Install module in: Administration » Modules
4. Go into module settings and fill the required and optional data.
5. Set module to "Live" working mode (The Testing mode is dedicated to developers only for testing purposes on unofficial testing environment).
6. Go into settings: Administration » Payment » Payment modules list, and leave checked Euro currency only. If you don't using Euro currency in your shop, your customers can't pay via ePlatby VUB.
7. Create testing product with amount 0.10 €.
8. Contact bank employee responsible for system implementation in your e-shop. He made testing of your module in order process. Provide URL to testing product.
9. If you are gladly notified by VUB bank the module ready to work in live environment.
10. Delete testing product from your e-shop.
11. While module installation the payment icon has been placed into product detail page of your eshop Front Office.
12. If any problem occurred, check your settings data filled into module first. If problem still persist, contact author of the module.

Encryption key

• encryption key (password) receive from bank by mail.
• encryption key is 64-character long string (please take care in overwriting) and its hexadecimal version to verify the correctness of overwriting it into electronic form.
• to verify your encryption key use following tool: string-functions.com
  and check the result with hexadecimal version by comparison.

Your secret key and data verification

Testing environment: nib.vub.sk/epay/merchant

Login data:

• MID (your merchant ID provided by VUB bank)
• Password (e-mail address on your contract with VUB bank)

ePlatby VUB service implementation steps

1. Sign contract with VUB bank, a.s. and get personal merchant ID and secret key for your e-commerce.
2. Buy, install and setup ePlatby VUB module.
3. Contact bank employee responsible for system implementation in your e-shop. He made testing of your module in order process.
4. If any problem occurred, check your settings data filled into module first. If problem still persist, contact module author.
5. If the testing was successful, module is ready to work in live environment.

ePlatby VUB service information

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

VSEOBECNA UVEROVA BANKA EPLATBY VUB MODULE - CHANGELOG

version 1.7.4 (09/29/2019)
    x fixed bug in validation process

version 1.7.3 (06/05/2019)
    x fixed bug when private message is added after unsuccessful payment

version 1.7.2 (07/02/2018)
    x updated a new VUB testing URL - https://nib.vub.sk/nepay/merchant

version 1.7.1 (12/03/2017)
    x fixed payment validation process for PrestaShop 1.7.2.x
    x fixed & improve the validation process
    x fixed bug where wrong an order status was marked as Default (module back-office)
    x fixed module translations
    x updated module documentation
    x improve commenting the code
    x fixed not mandatory variables
    x fixed translation of the order private message created by the module
    + added order reference code on the return page (when order after payment)

version 1.7.0 (12/26/2016)
    + initial release for PrestaShop 1.7.x (testing environment: PrestaShop 1.7.0.4)
    x fixed payment validation process for PrestaShop 1.7.2.x
    + front office redesign for PrestaShop 1.7 Classic theme
    + added Order payment status selectors
    + added a new ePlatby VUB payment status "Unknown"
    x changed way of testing mode - now using the official VUB API
    x moved validation script into "response" folder
    x fixed currency check function
    x updated module documentation
    x updated "Terms and conditions of use" document

version 1.6.9 (07/02/2018)
    x updated a new VUB testing URL - https://nib.vub.sk/nepay/merchant

version 1.6.8 (12/03/2017)
    x fixed & improve the validation process
    x fixed bug where wrong an order status was marked as Default (module back-office)
    x updated module documentation
    x improve commentig the code
    x fixed not mandatory variables
    x fixed translation of the order private message created by the module
    + added order reference code on the return page (when order after payment)

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 ePlatby VUB payment" and "Unknown ePlatby VUB 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.6 (12/13/2016)
    + added compatibility with "Advanced EU Compliance" module
    + added responsive feature for image icons

version 1.6.5 (11/28/2016)
    x changed testing process - added official VUB testing environment
    x updated module documentation - added new module testing process required by VUB Banka

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

version 1.6.3 (05/25/2015)
    + added product detail icon position and set as default
    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 (04/23/2015)
    x updated documentation
    x updated technical specification from VUB
    x updated testing URL
    - removed class "col-md-6" from payment.tpl

version 1.6.1 (04/20/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

version 1.2 (07/27/2013)
    x added full English and Slovak documentation

version 1.1 (06/17/2013)
    + added eplatbyvub.css to design front-end pages
    x small design improvements

version 1.0 (12/25/2012)
    + initial release for PrestaShop 1.5.x

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

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