Modul: eCard VÚB (NestPay) pre PrestaShop / thirty bees (platby kartou)

Platobná brána eCard VÚB umožňuje zákazníkom bezhotovostnú platbu debetnými a kreditnými kartami VISA, MasterCard a Diners Club za zakúpený tovar vo Vašom e-shope, v prospech Vášho bankového biznis účtu, vedeného vo Všeobecnej úverovej banke, a.s.. Modul zabezpečuje komunikáciu medzi Vašim internetovým obchodom PrestaShop a webom VÚB - vub.sk.

Vlastnosti modulu

• kompatibilita: PrestaShop 1.7.x, 1.6.x, 1.5.x
  
• podpora funkcie Multistore (viac obchodov)
• podpora funkcie "Rozšírený nákupný košík" v module "Súlad s požiadavkami EU"
• rýchla inštalácia
• jednoduché nastavenie modulu a implementácia platobnej brány
• 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ť typ predávaného tovaru
  • fyzický tovar
  • virtuálny tovar
  • služby
• podporované karty:
  • VISA
  • MasterCard
  • Diners Club
• podporované platobné meny:
  • Euro
  • Americký Dolár
  • Austrálsky dolár
  • Kanadský dolár
  • Švajčiarsky frank
  • Česká koruna
  • Dánska koruna
  • Anglická libra
  • Kuna
  • Forint
  • Yen
  • Zloty
  • Švédska koruna
• dostupné jazyky rozhrania eCard VÚB:
  • slovenský
  • český
  • anglický
  • maďarský
  • poľský
  • nemecký
  • ruský
• bezpečnosť poskytuje:
  • použitie technológie 3-D Secure
• dostupné preklady modulu: slovenský, český a anglický
• možnosť nastaviť vlastný stav objednávok pri čakajúcej, úspešnej a neúspešnej platbe
• zaznamenávanie a archivácia výsledkov platobných transakcií (neobsahujú žiadne platobné údaje klienta, či kariet) v databáze PrestaShopu pre reklamačné účely
• automatická implementácia ikony platobného systému a lôg akceptovaných bankových kariet vo verejnej časti Vášho e-shopu
• 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 eCard VÚB

Kroky implementácie platobnej brány eCard VÚB

1. Uzavrite s bankou zmluvu o prevádzkovaní služby pre už existujúci internetový obchod. Pri uzatváraní zmluvy jej poskytnite:
   • statickú IP adresu servera - môžete ju zistiť napr. na tejto stránke: get-site-ip.com
   • URL pri úspešnej platbe: https://DOMENAESHOPU.sk/modules/ecardvub/response/response.php
   • URL pri neúspešnej platbe: https://DOMENAESHOPU.sk/modules/ecardvub/response/response.php
2. Zakúpte, nainštalujte a nastavte modul do Vášho PrestaShop-u podľa priloženého manuálu (pozrite si "Inštalácia a testovanie modulu").
3. Vykonajte testovanie funkčnosti platobného modulu - VÚB Vám poskytne čísla testovacích kariet.
4. Ak bolo testovanie úspešné, modul je pripravený k prevádzke.
5. Ak bolo testovanie neúspešné, skontrolujte najskôr nastavenie modulu podľa manuálu a až potom kontaktujte autora modulu.

Informácie o službe eCard VÚB

Všetky aktuálne obchodné podmienky o prevádzkovaní služby eCard VÚB Vám poskytne Všeobecná úverová banka.
Prejdite prosím na web Všeobecnej úverovej banky: www.vub.sk

Inštalácia a testovanie modulu

1. Nahrajte priečinok "ecardvub" 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 menu, pre ktorú bola zmluva uzavretá.
4. Prihláste sa do testovacieho obchodníckeho prostredia testsecurepay.eway2pay.com pomocou údajov, ktoré ste obdržali od eCard VÚB:
   • ID klienta
   • Meno používateľa
   • Heslo
5. V časti "Administrácia > Nastavenia 3D" si vytvorte vlastný 3D kľúč.
6. Vytvorený 3D kľúč, spoločne s ID obchodníka uložte do nastavení modulu vo Vašom PrestaShope.
7. V module nastavte voľbu "Režim prevádzky" do stavu "testovací".
8. V časti "Pomoc > Dokumenty" si stiahnite archív EcommMerchant_VUB_SVK.zip. V ňom sa nachádza aj súbor s názvom "eCard_testovacie karty.xlsx", obsahujúci testovacie karty, pomocou ktorých zrealizujete rôzne testovacie platobné scenáre.
9. Po zrealizovaní testovania, oslovte eCard VÚB a požiadajte o kontrolu Vášho testovania.
10. Po schválení testovania bankou, zopakujte kroky č.5 a 6., avšak už v produkčnom obchodníckom prostredí: vub.eway2pay.co
11. Po úspešnom testovaní nastavte "Režim prevádzky" do stavu "produkčný" a tým je platobná brána eCard VÚB pripravená pre prácu v ostrej prevádzke vo Vašom e-shope.
12. Pri inštalácii modulu došlo k automatickému umiestneniu ikony platobného systému a platobných kariet v detaile produktu vo verejnej časti e-shopu.
13. 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 prosím autora modulu.

Archivácia platobných transakcií

Modul pri inštalácii vytvorí v databáze tabuľku "[PREFIX]_ecardvub_log", ktorá slúži na archivovanie základných údajov komunikácie platobného modulu a systému eCard VÚB (neukladajú sa žiadne citlivé údaje zákazníkov, či kariet). Pri odinštalovaní modulu sa táto tabuľka nezmaže, pretože údaje v nej je potrebné z dôvodu možných reklamácií archivovať.

Výpis záznamov platobných transakcií nájdete v ovládacom paneli modulu.

Časté otázky pri prevádzke modulu

V dizajne modulu eCard VÚB 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 eCard VÚB nájdite položky "module-ecardvub-payment" a "module-ecardvub-validation" a nastavte zobrazovanie stĺpcov podľa Vášho želania.

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