WooCommerce

WooCommerce is a marketplace plugin for wordpress. You can start selling your items in less than 15 minutes, and there are also many plugins to accomplish all your needs.

Gestpay develops and distributes a free plugin for WooCommerce.

Prerequisites

The only prerequisite is that you already know how to use Wordpress and WooCommerce, as a user. You won’t need coding skills to use the plugin.

To simplify the configuration, use a Wordpress instance deployed on a public server. Using it on a local server might be difficult since Gestpay might not be able to access your machine from outside.

How to install

Download the zip file and save to a known location on your hard drive.

In Wordpress, Plugins > Add New; search for Gestpay for WooCommerce and click install now.


Don’t forget to Activate the plugin.

If you want to manual install the plugin, you can find it in the Wordpress Plugin Repository.

Configure Gestpay for WooCommerce

Once installed and activated, you’ll can go to WooCommerce > Settings and click on Gestpay for WooCommerce tab to configure the plugin.

Here we will describe the configuration options.

Field Description
Account version Choose your plan to use Gestpay. Possible values are Gestpay Starter and Gestpay Professional.
GestPay Shop Login The unique Gestpay identifier. You can also use a test shop login (see below).
Here you can insert either the TEST shopLogin (starting with GESPAYXXXXX) or the production shop login, that consists of only numbers (example: If your login code to the Merchant Back-Office is XX912345, you should use only 912345).
IP Address The plugin will detect the server public IP. Use this IP to configure Gestpay.
Buyer email Check if you wish to send to Gestpay the buyer’s e-mail. Remember to enable the parameter in the Merchant Backoffice
Buyer name Check if you wish to send to Gestpay the buyer’s name. Remember to enable the parameter in the Merchant Backoffice.
Language Checking this option you can change the language of the payment page.
The languages available in Gestpay are italian, english, french, german and spanish.
To use this functionality you have to enable a multilingual plugin: Gestpay for WooCommerce is compatible with qTranslate-X and with WPML.
If you prefer to replicate the same website in many languages, you can define the constant WPLANG in wp-config.php, for example define('WPLANG', 'it_IT');.
Custom info Here you can insert custom data in the form of parameter=value, one per row. The following characters, together with the space character, are not admitted: & § ( ) * , ; : *P1* / /* [ ] ? = %.
Payment Types Check if you want to redirect your users directly to a specific payment method. To use this, enable the parameter in the Merchant Back Office.
Alternative Payments Here you can enable other systems, like Paypal, Consel, Masterpass, etc.
Sandbox mode Check if you want to redirect your payments to the test environment, where you can test the payment process without real credit card numbers and money.
Debug log Check if you want to save a log of the data sent to Gestpay. Useful for testing and for bug reporting.
Force response verification In case of problems with order status updates, check this option. The Gestpay response will be forcely verified.

Activate Gestpay for WooCommerce

Once you have set up your plugin with the Gestpay account, move to WooCommerce > Settings and select the Checkout tab.

Here you’ll see the Gestpay menu enabled. Depending on the configured alternative payments, you might find other payment methods. For example, in the image below you’ll see Gestpay Pro Paypal.


Clicking on Gestpay, you can:

Configuration for custom alternative payments enabled is similar.

Configure the Merchant Back Office

A merchant can configure the Merchant Back Office to receive requests from WooCommerce plugin. There are two environments available:

To request a test account, go to the registration page.

Configure Authentication

Gestpay will identify the merchant by comparing his IP address with the ones that are configured in the Merchant Back-Office. To insert your address or addresses, go to Configuration > Environment and click on IP Address.


Configure redirect addresses

Gestpay will notify the transaction status redirecting the browser to pages that are set up by the merchant (for example, success.php or error.php).

In Configuration > Environment click on Response Address and set the relevant data for customer care, fraud prevention, etc.

Then, set the Url for positive answer and the URL for negative answer. If your website address is http://yoursite.com, you have to set http://yoursite.com/?wc-api=WC_Gateway_Gestpay in both fields.


Note: it is very important that

?wc-api=WC_Gateway_Gestpay 

is appended to your website address. With this code, the plugin will understand that the call is from Gestpay and will do decrypt the call. Then, the user is redirected to WooCommerce’s configured Order Received page.

Note: It is not necessary to populate the field URL Server to Server.