GP WebPay pro PrestaShop (platební modul)

GP WebPay je internetová platební brána pro rychlé a bezpečné platby, která umožňuje platby tuzemskými i zahraničními kartami asociací MasterCard, VISA, Diners Club a American Express. Podporuje také platby digitální peněženkou MasterPass a MasterCard Mobile, které probíhají přes mobilní telefon pomocí QR kódu.

GP WebPay odpovídá celosvětovým standardům a splňuje nejpřísnější bezpečnostní požadavky MasterCard SecureCode a Verified by VISA a SafeKey, definované karetními asociacemi MasterCard, VISA a American Express. Tyto standardy jsou označovány jako 3D Secure a zaručují maximální bezpečnost plateb.

Vlastnosti modulu

• kompatibilita: PrestaShop 1.7.x
• podpora funkce Multistore (více obchodů)
• podpora funkce "Rozšířený nákupní košík" v modulu "Soulad s požadavky EU"
• možnost určit způsob objednávání
  • vytvoření objednávky před platbou (identifikátorem platby je číslo objednávky)
  • vytvoření objednávky po zaplacení (identifikátorem platby je číslo nákupního košíku)
• podporované karty:
  • MasterCard
  • VISA
  • Diners Club
  • American Express
  • MasterPass (digitální peněženka)
  • MasterCard Mobile (digitální peněženka)
• podporované platební měny:
  • Česká koruna
  • Euro
  • Anglická libra
  • Americký Dolar
  • Maďarský forint
  • Polský złoty
  • Ruský rubl
• banky umožňující platby GP WebPay:
  
  • Česká spořitelna (ČR)
  • Komerční Banka (ČR)
  • UniCredit Bank (ČR)
  • Raiffeisen Bank (ČR)
  • Slovenská sporiteľňa (Slovensko)
  • Československá obchodná banka (ČSOB) (Slovensko)
  • UniCredit Bank (Slovensko)
  • Latvijas pasta banka (Lotyšsko)
• možnost nastavit vlastní stav objednávek při čekající, úspěšné a neúspěšné platbě
• 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 GP WebPay
• dostupné překlady modulu: český, slovenský a anglický
• rychlá instalace
• snadné nastavení

Kroky implementace služby GP WebPay

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

Informace o službě GP WebPay

Všechny aktuální obchodní podmínky o provozování služeb GP WebPay Vám poskytne Vaše smluvní banka.
Přejděte prosím na web GP WebPay: www.gpwebpay.cz

Vygenerování soukromým klíčů (certifikátů)

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

1. Přejděte na portál: test.portal.gpwebpay.com
2. Přihlaste se prostřednictvím údajů, které Vám poskytlo GP WebPay:
   • Číslo obchodníka
   • Jméno
   • Heslo
3. Po úspěšném přihlášení přejděte prosím do části "Zpráva klíčů".
4. Vygenerujte si Váš testovací soukromý klíč následovně:
   1. Při generování si zvolte heslo.
   2. Vygenerovaný klíč s názvem "gpwebpay-pvk.key" si pak jako soubor uložte do Vašeho počítače.
   3. Portál Vás vyzve opět k jeho nahrání spolu s vložením hesla, které jste si zvolili v kroku 4.I.
5. Přejděte do nastavení modulu a vložte údaje:
   • číslo obchodníka
   • heslo privátního klíče použité v kroku 4.I.
6. Otevřete soubor "gpwebpay-pvk.key" v jednoduchém textovém editoru (Notepad apod.).
7. Zkopírujte (CTRL+C, ⌘C) obsah celého souboru do schránky Vašeho počítače a v nastaveních modulu ho vložte (CTRL+V, ⌘V) do pole "Soukromý klíč (testovací)".
8. Otestujte modul provedením testovací platby. Postupujte podle části "Instalace, nastavení a testování modulu". Číslo testovací karty a heslo Vám poskytne GP WebPay.
9. Celý proces opakujte i pro vygenerování Produkčního soukromého klíče s tím rozdílem, že se přihlásíte na portál portal.gpwebpay.com a vygenerovaný produkční soukromný klíč vložíte do pole modulu "Soukromý klíč (produkční)".

Instalace, nastavení a testování modulu

1. Nahrajte složku "gpwebpay" 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 do nastavení modulu a zadejte všechny potřebné údaje:
   • Číslo obchodníka
   • Heslo privátního klíče
   • Smluvní banka
   • vložte testovací soukromý klíč podle části "Vygenerování privátních klíčů (certifikátů)"
4. Režim provozu nastavte do stavu "testovací" a Způsob zpracování plateb na "automaticky (doporučeno)".
5. Přejděte k nastavením: Kontrolní panel » Moduly » Platební brány » Omezení na základě měny, a zaškrtněte stejné platební měny, které jste si nastavili také v ovládacím panelu modulu.
6. Proveďte otestování funkčnosti modulu a ověření jeho správné činnosti vytvořením testovací objednávky a platby (GP WebPay Vám poskytne číslo testovací karty).
7. Po úspěšném testování funkčnosti, pošlete e-mailem GP WebPay tentokrát soubor produkčního klíče (s příponou .cer). GP WebPay Vás bude opět informovat o úspěšném nahrání produkčního klíče do jejich systému.
8. Nastavte Režim provozu modulu do stavu "produkční". Tímto krokem je platební brána GP WebPay připravená pro práci v ostrém provozu.
9. 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.
10. 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 prosím autora modulu.

Archivace platebních transakcí

Modul při instalaci vytvoří v databázi tabulku "[PREFIX] _gpwebpay_log", která slouží pro archivaci základních údajů komunikace platebního modulu a systému GP WebPay (žá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 po dobu 5 let (podle dokumentace GP WebPay).

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

Časté dotazy při provozu modulu

V designu modulu GP WebPay 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 GP WebPay najděte položky "module-gpwebpay-payment", "module-gpwebpay-validation" a "module-gpwebpay-error" a nastavte zobrazování sloupců dle Vašeho přání.

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