eCard VÚB pro PrestaShop (modul pro karetní platby)

Platební brána eCard VÚB umožňuje zákazníkům bezhotovostní platbu debetními a kreditními kartami VISA, VISA Electron, MasterCard, Maestro, Diners Club a American Express za zakoupené zboží ve Vašem e-shopu, ve prospěch vašeho bankovního účtu vedeného ve Všeobecní úvěrové bance, a.s.. Modul zabezpečuje šifrovanou komunikaci mezi Vaším internetovým obchodem PrestaShop a webem VÚB - vub.sk.

Vlastnosti modulu

• kompatibilita: PrestaShop 1.5.x - 1.7.x
  
• podpora funkce Multistore (více obchodů)
• rychlá instalace
• snadné nastavení modulu a implementace platební brány
• podporovány karty:
  • VISA
  • VISA Electron
  • MasterCard
  • Maestro
  • Diners Club
  • American Express
• podporovány platební měny:
  • Česká koruna
  • Euro
  • Americký Dolar
  • Maďarský Forint
  • Polský Zloty
• dostupné jazyky rozhraní eCard VÚB:
  • slovenský
  • anglický
• bezpečnost poskytuje:
  • použití technologie 3-D Secure
• dostupné překlady modulu: český, slovenský a anglický
• zaznamenávání a archivace výsledků platebních transakcí (neobsahují žádné platební údaje klienta, zda karet) v databázi PrestaShopu pro reklamační účely
• automatická implementace ikony platebního systému a log akceptovaných bankovních karet ve veřejné části Vašeho e-shopu
• možnost měnit pozici platební ikony z administrace modulu (levý / pravý sloupec, stránka detailu produktu)
• možnost nastavit odkaz cílové statické (CMS) stránky z ikony eCard VÚB
• možnost nastavit vlastní stav objednávek při úspěšné a neúspěšné platbě

Kroky implementace platební brány eCard VÚB

1. Uzavřete s bankou smlouvu o provozování služby pro již existující internetový obchod
2. Zakupte, nainstalujte a nastavte modul do Vašeho PrestaShop-u podle přiloženého manuálu (viz. "Instalace a testování modulu").
3. Proveďte testování funkčnosti platebního modulu - VUB Vám poskytne testovací karty..
4. Pokud bylo testování úspěšné, modul je připraven k provozu.
5. Pokud bylo testování neúspěšné, zkontrolujte nejprve nastavení modulu podle manuálu a až pak kontaktujte autora modulu.

Informace o službě eCard VÚB

Všechny aktuální obchodní podmínky o provozování služeb eCard VÚB Vám poskytne Všeobecná úverová banka.
Přejděte prosím na web Všeobecní úvěrové banky: www.vub.sk

Instalace a testování modulu

1. Nahrajte složku "ecardvub" do složky /modules/ prostřednictvím FTP, nebo použijte nástroj pro nahrávání modulů v části Kontrolní panel » Moduly » Přidat nový modul.
2. Proveďte instalaci modulu v části: Kontrolní panel » Moduly
3. Přejděte k nastavením: Kontrolní panel » Moduly » Platební brány » Omezení na základě měny, a vyberte měnu, pro kterou byla smlouva uzavřena.
4. Přejděte do nastavení modulu a zadejte údaje:
   • ID obchodníka
   • 3D bezpečnostní klíč
   Současně nastavte i další vlastnosti modulu.
5. V modulu nastavte volbu "Režim provozu" do stavu "testovací".
6. Kontaktujte zaměstnance banky a domluvte se s ním na procesu testování.
7. Po úspěšném testování nastavte "Režim provozu" do stavu "produkční" a tím je platební brána eCard VÚB připravena pro práci v ostrém provozu ve Vašem e-shopu.
8. Při instalaci modulu došlo k automatickému umístění ikony platebního systému a platebních karet v detailu produktu ve veřejné části e-shopu.
9. Pokud by se vyskytl problém, zkontrolujte nejdříve správnost údajů vložených do nastavení modulu. Pokud problém přetrvává, kontaktujte autora modulu.

Archivace platebních transakcí

Modul při instalaci vytvoří v databázi tabulku "[PREFIX] _ecardvub_log", která slouží pro archivaci základních údajů komunikace platebního modulu a systému eCard VÚB (žádná citlivá data zákazníků). Při odinstalování modulu se tato tabulka nesmaže, protože údaje v ní je třeba z důvodu možných reklamací archivovat.

Výpis záznamů platebních transakcí naleznete v ovládacím panelu modulu.

Časté dotazy při provozu modulu

V designu modulu eCard VÚB ve veřejné části obchodu se mi zobrazuje pravý / levý sloupec šablony, i když se při jiných platebních modulech nezobrazuje. Kde a jak mohu nastavit zobrazení sloupců?
Odpověď: Přejděte prosím do části Kontrolní panel > Předvolby > Šablony a loga (Back Office > Preferences > Themes), při aktuálně zvolené šabloně klikněte na tlačítko "Upravit". Následně se dostanete do části, kde můžete ovládat zobrazování sloupců pro různé stránky e-shopu. Pro modul eCard VÚB najděte položky "module-ecardvub-payment" a "module-ecardvub-validation" a nastavte zobrazování sloupců dle Vašeho přání.

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