GP WebPay pre PrestaShop (platobný modul)

Účel modulu: Platobný modul pre PrestaShop zabezpečujúci príjem platieb kreditnými a debetnými kartami MasterCard, VISA, Diners Club a American Express.

GP WebPay je internetová platobná brána pre rýchle a bezpečné platby, ktorá umožňuje platby domácimi aj zahraničnými kartami asociáciou MasterCard, VISA, Diners Club a American Express. Podporuje tiež platby digitálnou peňaženkou MasterPass a MasterCard Mobile, ktoré prebiehajú cez mobilný telefón pomocou QR kódu.

GP WebPay zodpovedá celosvetovým štandardom a spĺňa najprísnejšie bezpečnostné požiadavky MasterCard SecureCode a Verified by VISA a SafeKey, definovanej kartovými asociáciami MasterCard, VISA a American Express. Tieto štandardy sú označované ako 3D Secure a zaručujú maximálnu bezpečnosť platieb.

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"
• 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ť a párovať stavy objednávok, ktoré modul priraďuje objendávkam v závislosti od stavu platby priamo v administrácii modulu
• podporované karty:
  • MasterCard
  • VISA
  • Diners Club
  • American Express
  • MasterPass (digitálna peňaženka)
  • MasterCard Mobile (digitálna peňaženka)
• dostupné platobné meny:
  • Euro
  • Česká koruna
  • Anglická libra
  • Americký Dolár
  • Maďarský forint
  • Poľský złoty
  • Ruský rubeľ
• banky umožňujúce platby GP WebPay:
  • Slovenská sporiteľňa (Slovensko)
  • Československá obchodná banka (ČSOB) (Slovensko)
  • UniCredit Bank (Slovensko)
  • Česká spořitelna (ČR)
  • Komerční Banka (ČR)
  • UniCredit Bank (ČR)
  • Raiffeisen Bank (ČR)
  • Latvijas pasta banka (Lotyšsko)
• automatická implementácia ikony platobného systému a lôg akceptovaných bankových kariet vo verejnej časti Vášho obchodu
• automatická implementácia príslušných nových stavov objednávok a notifikačných e-mailových šablón do PrestaShop-u
• 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 GP WebPay
• dostupné preklady modulu: slovenský, český a anglický
• rýchla inštalácia
• jednoduché nastavenie

Kroky implementácie služby GP WebPay

1. Uzavrite s Vašou bankou zmluvu o prevádzkovaní služby pre už existujúci internetový obchod.
2. Od GP WebPay obdržíte osobné číslo obchodníka a údaje pre testovanie.
3. Zakúpte, nainštalujte a nastavte modul do Vášho PrestaShop-u podľa priloženého manuálu (pozrite si "Inštalácia, nastavenie a testovanie modulu").
4. Vykonajte testovanie funkčnosti platobného modulu.
5. Ak bolo testovanie úspešné, modul je pripravený k prevádzke.
6. 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 GP WebPay

Všetky aktuálne obchodné podmienky o prevádzkovaní služby GP WebPay Vám poskytne Vaša zmluvná banka.
Prejdite prosím na web GP WebPay: www.gpwebpay.cz

Vygenerovanie súkromných kľúčov (certifikátov)

Upozornenie: Proces vytovrenia súkromných kľúčov sa skladá z generovania testovacieho a potom produkčného kľúča!

1. Prejdite na portál: test.portal.gpwebpay.com
2. Prihláste sa prostredníctvom údajov, ktoré Vám poskytla GP WebPay:
   • Číslo obchodníka
   • Meno
   • Heslo
3. Po úspešnom prihlásení prejdite prosím do časti "Správa kľúčov".
4. Vygenerujte si Váš testovací súkromný kľúč nasledujúcim spôsobom:
   1. Pri generovaní si zvoľte heslo.
   2. Vygenerovaný kľúč s názvom "gpwebpay-pvk.key" si potom ako súbor uložte do Vášho počítača.
   3. Portál Vás vyzve opäť k jeho nahratiu spolu s vložením hesla, ktoré ste si zvolili v kroku 4.I.
5. Prejdite do nastavenia modulu, vložte a uložte údaje:
   • číslo obchodníka
   • heslo privátneho kľúča použité v kroku 4.I.
6. Otvorte súbor "gpwebpay-pvk.key" v jednoduchom textovom editore (Notepad apod.).
7. Skopírujte (CTRL+C, ⌘C) obsah celého súboru do schránky Vášho počítača a v nastaveniach modulu ho vložte (CTRL+V, ⌘V) do poľa "Súkromný kľúč (testovací)".
8. Otestujte modul vykonaním testovacej platby. Postupujte podľa časti "Inštalácia, nastavenie a testovanie modulu". Číslo testovacej karty a heslo Vám poskytne GP WebPay.
9. Celý proces opakujte aj pre vygenerovanie Produkčného súkromného kľúča s tým rozdielom, že sa prihlásite na portál portal.gpwebpay.com a vygenerovaný produkčný súkromný kľúč vložíte do poľa modulu "Súkromný kľúč (produkčný)".

Inštalácia, nastavenie a testovanie modulu

1. Nahrajte priečinok "gpwebpay" 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 do nastavení modulu a zadajte všetky potrebné údaje:
   • Číslo obchodníka
   • Heslo privátneho kľúča
   • Zmluvná banka
   • vložte testovací súkromný kľúč podľa časti "Vygenerovanie súkromných kľúčov (certifikátov)"
4. Režim prevádzky nastavte do stavu "testovací" a Spôsob spracovania platieb na "automatický (odporúčané)".
5. Prejdite k nastaveniam: Ovládací panel » Moduly » Platobné brány » Obmedzenia na základe meny, a zaškrtnite rovnaké platobné meny, ktoré ste si nastavili aj v ovládacom paneli modulu.
6. Vykonajte otestovanie funkčnosti modulu a overenie jeho správnej činnosti vytvorením testovacej objednávky a platby (GP WebPay Vám poskytne číslo testovacej karty a heslo).
7. Po úspešnom otestovaní funkčnosti Vám GP WebPay zašle údaje pre vygenerovanie produkčného súkromného kľúča.
8. Implementujte produkčný súkromný kľúč podľa časti "Vygenerovanie súkromných kľúčov (certifikátov)".
9. Nastavte Režim prevádzky modulu do stavu "produkčný". Týmto krokom je platobná brána GP WebPay pripravená pre prácu v ostrej prevádzke.
10. 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.
11. 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]_gpwebpay_log", ktorá slúži na archivovanie základných údajov komunikácie platobného modulu a systému GP WebPay (žiadne citlivé údaje zákazníkov). 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ť po dobu 5 rokov (podľa dokumentácie GP WebPay).

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

Časté otázky pri prevádzke modulu

V dizajne modulu GP WebPay 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 Upraviť. Následne sa dostanete do časti, kde môžete ovládať zobrazovanie stĺpcov pre rôzne stránky e-shopu. Pre modul GP WebPay nájdite položky "module-gpwebpay-payment", "module-gpwebpay-validation" a "module-gpwebpay-error" a nastavte zobrazovanie stĺpcov podľa Vášho želania.

GP WEBPAY PAYMENT GATEWAY MODULE - CHANGELOG

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

version 1.7.7 (04/26/2021)
    x updated release - Merchant Integration Manual HTTP API; version: 1.11 used
    + added Apple Pay & Google Pay logos
    + added explanation instruction for customers on the Checkout
    + added fields for testing Merchant ID and Private key password - allow switch between Live & Testing environment without changing module setting
    + added an PHP warning alert
    + added a custom hook {hook h='displaygpwebpayicons'} in order to display module payment icons everywhere you want
    + added Back Office CSS file (displayBackOfficeHeader hook)
    x various code improvements
    x updated module documentation
    - removed module JS file that may affected PrestaShop BO
    + added an option to redirect customer back into checkout when the payment was not successful (for "place an order after the payment" order method)

version 1.7.6 (09/16/2020)
    + added UniCredit Bank (Slovakia)
    x updated module documentation
    + added an alert when Friendly URLs are disabled

version 1.7.5 (05/03/2020)
    + added private notes field
    + added selector for PrestaShop theme (on/off Material Design Icons)
    x payment icons redesign
    x improved module back office - added an icons and buttons
    x fixed return link when the cardholder canceled the payment (PRCODE = 50)

version 1.7.4 (06/28/2019)
    + added "REFERENCENUMBER" parameter for pairing the payments

version 1.7.3 (06/13/2018)
    x changed payment description
    x removed CSOB Cz

version 1.7.2 (03/19/2018)
    x fixed currency ID in the payment process 
    x fixed an order of the variables in the URL

version 1.7.1 (02/22/2018)
    x fixed bug in validation process
    x removed max. length parameter for Private key password

version 1.7.0 (12/31/2017)
    + initial release for PrestaShop 1.7.x (testing environment: PrestaShop 1.7.2.4)
    + front office redesign for PrestaShop 1.7 Classic theme

----------------- PrestaShop 1.6.x only -----------------

version 1.6.5 (09/16/2020)
    + added UniCredit Bank (Slovakia)
    x updated module documentation

version 1.6.4 (05/03/2020)
    + added "REFERENCENUMBER" parameter for pairing the payments
    x fixed displaying the card logos on the checkout page
    x fixed return link when the cardholder canceled the payment (PRCODE = 50)

version 1.6.3 (06/13/2018)
    x changed payment description
    x removed CSOB Cz

version 1.6.2 (04/10/2018)
    x fixed currency ID in the payment process
    x fixed an order of the variables in the URL

version 1.6.1 (02/22/2018)
    x fixed bug in validation process
    x removed max. length parameter for Private key password

version 1.6.0 (12/31/2017)
    x completely rewrited module code
    + added dual payment method: Order method selector (creating an order before or after the payment)
    + added new payment statuse "Awaiting GP WebPay payment"
    + added Order payment status selectors to freedom in pairing module statuses with PrestaShop built-in order statuses
    + added CMS page selector for icon destination link
    x fixed compatibility with "Advanced EU Compliance" module
    x changed the way to store private keys
    x improved testing mode
    x updated card payment logos
    x updated editable source file for card payment logos
    x updated module documentation
    x updated "Terms and conditions of use" document
    x improved the module code

----------------- PrestaShop 1.5.x + 1.6.x -----------------

version 1.3.0 (05/04/2017)
    + added payment URL for Ceska sporitelna
    + added compatibility with "Advanced EU Compliance" module
    x important: fix of RESULTTEXT and MD return parameters (parameters are not mandatory).
    x "img" and "css" folders moved into "views" folder
    x updated module documentation
    x moved validation script into "response" folder

version 1.2.1 (04/14/2017)
    + added correct payment URL for Slovenska sporitelna
    x fixed deprecated methods & class names for PHP 7
    x fixed URL's for SSL
    x minor code changes
    x updated module documentation
    x updated "Terms and conditions of use" document

version 1.2.0 (10/14/2016)
    + added new supported bank - Slovenska sporitelna a.s.
    x updated module documentation - added new way private key generation
    x moved validation.php into "response" folder
    x fixed private message (removed HTML elements) saved in the order
    x correction of Czech translation
    x fixed transaction record table & limited on 50 rows
    - removed application for generating kyes by old way

version 1.1.1 (08/01/2016)
    x changed length of Private key password field

version 1.1.0 (01/16/2016)
    + module compatibility for PrestaShop 1.6.x and 1.5.x
    + added Multi-store feature support
    + added payment icons and position control in module control panel
    + added selector for initial payment status
    + added payment records listing
    x updated available Bank and Currency list
    x redesign module Back office for PrestaShop 1.6.x
    x updated and improved module Documentation

----------------- PrestaShop 1.4.x -----------------

version 1.0.0 (12/25/2012)
    + initial release for PrestaShop 1.4.x

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

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