GP WebPay for PrestaShop (payment gateway)

GP WebPay payment gateway enables payments using domestic and international cards issued by the MasterCard, VISA, Diners Club and American Express associations. It also supports payments using the digital wallet MasterPass and MasterCard Mobile.

GP WebPay conforms to international standards and it meets the strictest safety requirements of the MasterCard SecureCode, Verified by VISA and SafeKey standards as defined by the MasterCard, VISA and American Express card associations. These standards are designated as 3D Secure and they ensure maximum payment security.

Module features

• compatibility: PrestaShop 1.7.x, 1.6.x, 1.5.x
• Multistore (Multiple shops) feature supported
• quick module installation
• easy module setup
• supported cards:
  • MasterCard
  • VISA
  • Diners Club
  • American Express
  • MasterPass (digital wallet)
  • MasterCard Mobile (digital wallet)
• supported payment currencies:
  • Euro
  • US Dollar
  • Pound sterling
  • Czech koruna
  • Hungarian forint
  • Polish złoty
  • Russian ruble
• banks allowing GP WebPay payments:
  • Slovenska sporitelna (Slovakia)
  • UniCredit Bank (Slovakia)
  • Ceskoslovenska obchodna banka (CSOB) (Slovakia)
  • Ceska sporitelna (Czech republic)
  • Komercni Banka (Czech republic)
  • UniCredit Bank (Czech republic)
  • Raiffeisen Bank (Czech republic)
  • Latvijas pasta banka (Latvia)
• languages available: English, Czech, Slovak
• the possibility of using the three payment currencies simultaneously
• the possibility to choose order status when customers return into eshop after the payment
• automatic payment and card icon implementation into Front Office
• payment icon position control via module administration (left / right column, product detail page)

GP WebPay service implementation steps

1. Sign contract with your bank for an existing eshop.
2. GP WebPay provide you merchant ID and information for testing.
3. Buy, install and setup GP WebPay module in your PrestaShop (see "Installation, setup and module testing").
4. Test the module in the order process.
5. If the testing was successful, module is ready to work in live environment.
6. If any problem occurred, check your settings data filled into module first. If problem still persist, please contact module author.

GP WebPay service information

All current terms and conditions for GP WebPay service will give you bank.
Please, go to GP WebPay website: www.gpwebpay.cz

Installation, setup and module testing

1. Upload "gpwebpay" folder into /modules/ folder via FTP or use module upload tool in Back Office » Modules to upload module package.
2. Install module in: Back Office » Modules
3. Go into module settings and fill the required following data.:
   • Merchant Number
   • Private key password
   • Bank
   • Implement the testing private key - see "Generate private keys (certificates)"
4. Set Working Mode option on "Testing" value, and Payment processing Mode on "Automatic (recommended)" value.
5. Go into settings: Back Office » Payment » Payment modules list, and leave checked the same currencies as you using for GP WebPay module.
6. Test the module in order process (GP WebPay provide to you testing card number).
7. When testing is successful, send your Live key (.cer extension file) into GP WebPay company.
8. Set Working Mode option on "Live" value. With this step is module ready for working in live environment.
9. While module installation the payment icon has been placed into product detail page of your eshop Front Office.
10. If any problem occurred, check your settings data filled into module first. If problem still persist, please contact module author.

Payment log

Module using "[PREFIX] _gpwebpay_log" database table for storing the records about GP WebPay payments in your PrestaShop (no sensitive customer data). This table stay untouched if the module will be uninstall or removed. The payment records need to be archived for 5 years.

Last 50 records are listed and available in the GP WebPay module back office.

FAQ: Frequently Asked Questions

I'd like to hide left / right column in GP WebPay module pages for Front office. Where and how can I adjust it?
Answer: Go into Back Office > Preferences > Themes, and click Edit for current theme. Now you allowed to change displaying the columns for various store pages. Find "module-gpwebpay-payment", "module-gpwebpay-validation" and "module-gpwebpay-error" records for GP WebPay module and adjust displaying columns for your wish.

GP WEBPAY PAYMENT GATEWAY MODULE - CHANGELOG

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

version 1.7.10 (12/25/2021)
    + added displayAdminOrderMainBottom hook
    + added information & action panel about card transaction in the back-office order detail 
    + added order payment record if payment state has logable option allowed
    + added an option to choose payment variable symbol type (Order ID or Order reference)
    + added link to list of Payment return codes
    x fixed bug of validating payment in the testing mode (Live Merchant Number was provided instead Testing Merchant Number)

version 1.7.9 (12/01/2021)
    + added an alert about Phone / Mobile number field requirement in customers addresses
    + added phone and mobile phone into ADDINFO parameter
    + added online module documentation
    x fixed variables for inserting a tracking code
    x fixed bug in association of including tracking_codes.tpl template
    x fixed width of URL in debugging mode

version 1.7.8 (09/20/2021)
    MANDATORY UPDATE RELEASE - Merchant Integration Manual HTTP API; version: 1.13 used
    + added ADDINFO parameter (mandatory from 09/30/2021 - the older module versions stop working)

    + 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 detial 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 "modern" e-mail templates + TWIG template for generate HTML templates
    + added log file to recording payment transactions for debugging purposes

    - removed useless payment step - the customer is redirected on payment gateway directly from the checkout page

    x modified multi-currency support
    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 improved module code
    x updated module documentation
    x simplified of the payment execution template
    x updated notification email templates - added "Finish Payment" button
    x updated VISA logo, 2021 version

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.7 (12/25/2021)
    + added an alert about Phone / Mobile number field requirement in customers addresses
    + added phone and mobile phone into ADDINFO parameter
    + added online module documentation
    + added order payment record if payment state has logable option allowed
    + added link to list of Payment return codes
    + added an option to choose payment variable symbol type (Order ID or Order reference)
    x fixed variables for inserting a tracking code
    x fixed bug in association of including tracking_codes.tpl template
    x fixed width of URL in debugging mode
    x fixed bug of validating payment in the testing mode (Live Merchant Number was provided instead Testing Merchant Number)

version 1.6.6 (09/29/2021)
    MANDATORY UPDATE RELEASE - Merchant Integration Manual HTTP API; version: 1.13 used
    + added ADDINFO parameter (mandatory from 09/30/2021 - the older module versions stop working)

    + 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 detial 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 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)
    + 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

    - 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 - thanks Mr. Jiri Virt (virt@volny.cz)
    x modified multi-currency support
    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 and VISA Electron logo, 2021 version
    x various code improvements
    x updated module documentation

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